Method: places.get

Obtenez les détails d'un lieu en fonction de son nom de ressource, qui est une chaîne au format places/{placeId}.

Requête HTTP

GET https://places.googleapis.com/v1/{name=places/*}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource d'un lieu au format places/{placeId}.

Paramètres de requête

Paramètres
languageCode

string

Facultatif. Les détails du lieu s'affichent dans la langue de préférence, si elle est disponible.

Liste actuelle des langues compatibles : https://developers.google.com/maps/faq#languagesupport.

regionCode

string

Facultatif. Code de pays/région Unicode (CLDR) de l'emplacement d'où provient la requête. Ce paramètre permet d'afficher les détails du lieu, comme le nom du lieu spécifique à la région, s'il est disponible. Le paramètre peut affecter les résultats en fonction de la loi applicable. Pour en savoir plus, consultez https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Notez que les codes de région à trois chiffres ne sont pas acceptés pour le moment.

sessionToken

string

Facultatif. Chaîne qui identifie une session Autocomplete à des fins de facturation. Doit être une chaîne base64 sécurisée pour les URL et les noms de fichiers, comportant au maximum 36 caractères ASCII. Dans le cas contraire, une erreur INVALID_ARGUMENT est renvoyée.

La session commence lorsque l'utilisateur commence à saisir une requête et se termine lorsqu'il sélectionne un lieu et qu'un appel à Place Details ou Address Validation est effectué. Chaque session peut comporter plusieurs requêtes, suivies d'une requête Place Details ou Address Validation. Les identifiants utilisés pour chaque requête d'une session doivent appartenir au même projet de la console Google Cloud. Une fois la session terminée, le jeton n'est plus valide. Votre application doit générer un nouveau jeton pour chaque session. Si le paramètre sessionToken est omis ou si vous réutilisez un jeton de session, la session est facturée comme si aucun jeton de session n'avait été fourni (chaque requête est facturée séparément).

Nous vous recommandons de respecter les consignes suivantes :

  • Utilisez des jetons de session pour tous les appels Place Autocomplete.
  • Générez un nouveau jeton pour chaque session. Nous vous recommandons d'utiliser la version 4 de l'UUID.
  • Assurez-vous que les identifiants utilisés pour toutes les requêtes Place Autocomplete, Place Details et Address Validation d'une session appartiennent au même projet Cloud Console.
  • N'oubliez pas de transmettre un jeton de session unique pour chaque nouvelle session. Si vous utilisez le même jeton pour plusieurs sessions, chaque requête sera facturée individuellement.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Place.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/maps-platform.places.details
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform