Method: places.get

Obtenez les informations 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 la ressource d'un lieu, au format places/{placeId}.

Paramètres de requête

Paramètres
languageCode

string

Facultatif. Les informations sur le lieu s'affichent dans la langue préférée, le cas échéant.

Liste actuelle des langues disponibles : 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, le cas échéant. Le paramètre peut avoir une incidence sur les résultats en fonction de la législation applicable. Pour en savoir plus, consultez la page 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 au format base64 sans risque pour les URL et les noms de fichiers, avec une longueur maximale de 36 caractères ASCII. Sinon, 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 Google Cloud Console. 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 vous omettez le paramètre sessionToken ou si vous réutilisez un jeton de session, la session est facturée comme si aucun jeton n'était 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, Places Details et Validation d'adresse au cours 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 est 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.