Place Field Migration (open_now, utc_offset)

I campi Places opening_hours.open_now e utc_offset sono deprecati dal 20 novembre 2019 e verranno disattivati il 20 febbraio 2021. Questi campi sono deprecati SOLO nell'API Places Library, Maps JavaScript. Questa guida mostra come aggiornare il codice per interrompere l'uso di questi campi.

Campo opening_hours.open_now

Questa sezione mostra come aggiornare questa funzionalità per ogni tipo di richiesta di Places.

Richieste Place Details

Il campo opening_hours.open_now è sostituito dal metodo opening_hours.isOpen().

Per le richieste di dettagli posizione, anziché richiedere opening_hours.open_now nel parametro di richiesta fields, includi opening_hours e utc_offset_minutes nel parametro di richiesta fields, quindi chiama il metodo opening_hours.isOpen() nell'oggetto google.maps.places.PlaceResult restituito per verificare se il luogo è aperto. L'esempio seguente mostra una richiesta Dettagli luogo che determina se un luogo è aperto:

new google.maps.places.PlacesService(attrContainer).getDetails({
  placeId: '...',
  fields: ['opening_hours','utc_offset_minutes'],
  }, function (place, status) {
    if (status !== 'OK') return; // something went wrong
    const isOpenAtTime = place.opening_hours.isOpen(new Date('December 17, 2020 03:24:00'));
    if (isOpenAtTime) {
        // We know it's open.
    }

    const isOpenNow = place.opening_hours.isOpen();
    if (isOpenNow) {
        // We know it's open.
    }
});

Richieste di ricerca di luoghi

Per le richieste di ricerca dei luoghi, il campo opening_hours.open_now non può essere sostituito. Ti consigliamo di effettuare una richiesta Dettagli luogo per ottenere informazioni su opening_hours.

Richieste di ricerca nelle vicinanze e ricerca testuale

Per le richieste di Ricerca nelle vicinanze e Ricerca testuale, puoi utilizzare il parametro di richiesta openNow, che applica un filtro ai risultati in modo da includere solo i luoghi attualmente aperti.

  • openNow:false restituisce tutti i luoghi.
  • openNow:true restituisce solo i luoghi attualmente aperti.

Per elencare tutti i luoghi E indicare lo stato openNow, prima invia una richiesta utilizzando openNow:false per ottenere tutti i luoghi, poi invia una richiesta utilizzando openNow:true per visualizzare solo i luoghi aperti. Quindi, unisci le risposte.

Campo utc_offset

Nelle richieste Dettagli luogo, il campo utc_offset è sostituito dal campo utc_offset_minutes. È sufficiente sostituire le occorrenze di utc_offset con utc_offset_minutes nel parametro di richiesta fields e durante la lettura di queste informazioni da PlaceResult.