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'afficheront dans la langue préférée, le cas échéant.

Liste des langues actuellement acceptées: https://developers.google.com/maps/faq#languagesupport.

regionCode

string

Facultatif. Le code pays/région Unicode (CLDR) de l'emplacement d'où provient la requête. Ce paramètre permet d'afficher des détails sur le lieu, comme son nom spécifique à une 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 régionaux à trois chiffres ne sont pas acceptés pour le moment.

sessionToken

string

Facultatif. Chaîne qui identifie une session de saisie semi-automatique à des fins de facturation. Il doit s'agir d'une chaîne en base64 avec nom de fichier et URL ne dépassant pas 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 au cours 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 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 un UUID version 4.
  • Assurez-vous que les identifiants utilisés pour toutes les requêtes Place Autocomplete, Place Details et Address Validation au cours d'une session appartiennent au même projet de la console Cloud.
  • 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.