Migration du champ Place (open_now, utc_offset)

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Les champs Places opening_hours.open_now et utc_offset sont obsolètes depuis le 20 novembre 2019 et seront désactivés le 20 février 2021. Ces champs ne sont obsolètes que dans l'API Places Library et Maps JavaScript. Ce guide vous explique comment mettre à jour votre code pour cesser d'utiliser ces champs.

Champ opening_hours.open_now

Cette section explique comment mettre à jour cette fonctionnalité pour chaque type de requête Places.

Requêtes Place Details

Le champ opening_hours.open_now est remplacé par la méthode opening_hours.isOpen().

Pour les requêtes de détails de lieu, au lieu de demander opening_hours.open_now dans le paramètre de requête fields, incluez opening_hours et utc_offset_minutes dans le paramètre de requête fields, puis appelez la méthode opening_hours.isOpen() sur l'objet google.maps.places.PlaceResult renvoyé pour vérifier si le lieu est ouvert. L'exemple suivant montre une requête Places Details qui détermine si un lieu est ouvert:

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.
    }
});

Requêtes Find Place

Pour les requêtes Find Place, le champ opening_hours.open_now ne peut pas être remplacé. Nous vous recommandons d'envoyer une requête Places Details pour obtenir des informations sur opening_hours.

Requêtes de recherche à proximité &texte

Pour les requêtes Nearby Search et Text Search, vous pouvez utiliser le paramètre de requête openNow, qui permet de filtrer les résultats pour n'inclure que les lieux actuellement ouverts.

  • openNow:false renvoie tous les lieux.
  • openNow:true ne renvoie que les établissements actuellement ouverts.

Pour répertorier tous les lieux ET indiquer l'état de openNow, envoyez d'abord une requête à l'aide de openNow:false pour obtenir tous les lieux, puis exécutez une requête à l'aide de openNow:true pour obtenir uniquement les lieux ouverts. Ensuite, fusionnez les réponses.

Champ utc_offset

Dans les requêtes Place Details, le champ utc_offset est remplacé par le champ utc_offset_minutes. Remplacez simplement les occurrences de utc_offset par utc_offset_minutes dans le paramètre de requête fields et lors de la lecture de ces informations à partir de PlaceResult.