Method: places.get

Details zu einem Ort anhand seines Ressourcennamens abrufen. Der Ressourcennamen ist ein String im Format places/{placeId}.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname eines Orts im Format places/{placeId}.

Suchparameter

Parameter
languageCode

string

Optional. Ortsdetails werden in der bevorzugten Sprache angezeigt, sofern verfügbar.

Aktuelle Liste der unterstützten Sprachen: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Optional. Der Länder-/Regionscode (CLDR) des Standorts, von dem die Anfrage stammt. Dieser Parameter wird verwendet, um die Ortsdetails wie den regionsspezifischen Ortsnamen anzuzeigen, sofern verfügbar. Der Parameter kann sich je nach geltendem Recht auf die Ergebnisse auswirken. Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Dreistellige Regionscodes werden derzeit nicht unterstützt.
sessionToken

string

Optional. Ein String, der eine Autocomplete-Sitzung zu Abrechnungszwecken identifiziert. Muss ein URL- und dateinamesicherer Base64-String mit maximal 36 ASCII-Zeichen sein. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.

Die Sitzung wird gestartet, wenn der Nutzer mit der Eingabe beginnt, und endet, wenn er einen Ort auswählt und ein Aufruf von „Place Details“ oder „Address Validation“ erfolgt. Jede Sitzung kann mehrere Abfragen und eine „Place Details“- oder „Address Validation“-Anfrage umfassen. Die für jede Anfrage innerhalb einer Sitzung verwendeten Anmeldedaten müssen zum selben Google Cloud Console-Projekt gehören. Nach Beendigung einer Sitzung ist das Token nicht mehr gültig. Ihre App muss für jede Sitzung ein neues Token generieren. Wenn der Parameter sessionToken weggelassen wird oder Sie ein Sitzungstoken wiederverwenden, wird die Sitzung so abgerechnet, als wäre kein Sitzungstoken angegeben worden (jede Anfrage wird separat abgerechnet).

Wir empfehlen folgende Richtlinien:

  • Verwenden Sie Sitzungstokens für alle Place Autocomplete-Aufrufe.
  • Generieren Sie für jede Sitzung ein neues Token. Wir empfehlen die Verwendung einer UUID der Version 4.
  • Achten Sie darauf, dass die für alle Place Autocomplete-, Place Details- und Address Validation-Anfragen innerhalb einer Sitzung verwendeten Anmeldedaten zum selben Cloud Console-Projekt gehören.
  • Für jede neue Sitzung muss ein eindeutiges Sitzungstoken übergeben werden. Wenn Sie dasselbe Token für mehrere Sitzungen verwenden, wird jede Anfrage einzeln abgerechnet.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Place.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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