Migrer les champs Place (open_now, utc_offset)

Les champs Places opening_hours.open_now et utc_offset sont obsolètes depuis le 20 novembre 2019 et ont été désactivés le 20 février 2021. Ces champs ne sont obsolètes QUE dans la bibliothèque Places, API Maps JavaScript. Ce guide vous explique comment mettre à jour votre code pour ne plus 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 Place Details, 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 Place 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 Place Details pour obtenir les informations opening_hours.

Requêtes Nearby Search et Text Search

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 lieux qui sont ouverts en ce moment.

Pour lister tous les lieux ET indiquer l'état d'openNow, envoyez d'abord une requête en utilisant openNow:false pour obtenir tous les lieux, puis exécutez une requête utilisant openNow:true pour n'obtenir que 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 d'utc_offset par utc_offset_minutes dans le paramètre de requête fields et lorsque ces informations sont lues à partir de PlaceResult.