Migrazione dei campi dei luoghi (open_now, utc_offset)

I campi Places opening_hours.open_now e utc_offset sono stati ritirati il 20 novembre 2019 e verranno disattivati il 20 febbraio 2021. Questi campi sono stati ritirati SOLO nella libreria Places, API Maps JavaScript. Questa guida mostra come aggiornare il codice per interrompere l'utilizzo di questi campi.

Campo opening_hours.open_now

In questa sezione viene illustrato come aggiornare questa funzionalità per ogni tipo di richiesta Places.

Richieste Places Details

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

Per le richieste Place Details, anziché richiedere opening_hours.open_now nel parametro della richiesta fields, includi opening_hours e utc_offset_minutes nel parametro della richiesta fields, quindi chiama il metodo opening_hours.isOpen() sull'oggetto google.maps.places.PlaceResult restituito per verificare se il luogo è aperto. L'esempio seguente mostra una richiesta Places Details 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 Trova luogo

Per le richieste Trova luogo, non esiste una sostituzione per il campo opening_hours.open_now. Ti consigliamo di effettuare una richiesta Places Details per ottenere informazioni opening_hours.

Richieste Nearby Search e Ricerca testuale

Per le richieste Nearby Search e Ricerca testuale, puoi utilizzare il openNow parametro della richiesta, che ha l'effetto di filtrare i 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, effettua prima una richiesta utilizzando openNow:false per ottenere tutti i luoghi, quindi effettua una richiesta utilizzando openNow:true per ottenere solo i luoghi aperti. Poi unisci le risposte.

Campo utc_offset

Nelle richieste Place Details, il campo utc_offset viene sostituito dal campo utc_offset_minutes. Basta sostituire le occorrenze di utc_offset con utc_offset_minutes nel parametro della richiesta fields e quando leggi queste informazioni da PlaceResult.