Method: places.get

Rufen Sie die Details zu einem Ort anhand des Ressourcennamens ab. Dieser 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

Parameters
name

string

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

Abfrageparameter

Parameters
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 Unicode-Ländercode (CLDR) des Standorts, von dem die Anfrage stammt. Mit diesem Parameter werden die Ortsdetails angezeigt, z. B. der regionsspezifische Ortsname (falls verfügbar). Der Parameter kann sich gemäß anwendbarem Recht auf 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 Dateiname-sicherer Base64-String mit maximal 36 ASCII-Zeichen sein. Andernfalls wird der Fehler INVALID_ ARGUMENT zurückgegeben.

Die Sitzung beginnt, wenn der Nutzer mit der Eingabe einer Suchanfrage beginnt, und endet, wenn er einen Ort auswählt und ein Aufruf von Place Details oder Address Validation ausgeführt wird. Jede Sitzung kann mehrere Abfragen umfassen, gefolgt von einer „Place Details“- oder „Address Validation“-Anfrage. Die für die einzelnen Anfragen innerhalb einer Sitzung verwendeten Anmeldedaten müssen zum selben Google Cloud Console-Projekt gehören. Sobald eine Sitzung beendet ist, 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. Es wird empfohlen, eine UUID der Version 4 zu verwenden.
  • Die Anmeldedaten, die für alle „Place Autocomplete“-, „Place Details“- und „Address Validation“-Anfragen innerhalb einer Sitzung verwendet werden, müssen zum selben Cloud Console-Projekt gehören.
  • Für jede neue Sitzung muss ein eindeutiges Sitzungstoken übergeben werden. Wenn Sie dasselbe Token für mehr als eine Sitzung verwenden, wird jede Anfrage einzeln in Rechnung gestellt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

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