Package google.maps.places.v1

Index

Orte

Dienstdefinition für die Places API. Hinweis: Für jede Anfrage (außer für Autocomplete- und GetPhotoMedia-Anfragen) ist eine Feldmaske erforderlich, die außerhalb des Anfrage-Protos festgelegt wird (all/* wird nicht angenommen). Die Feldmaske kann über den HTTP-Header X-Goog-FieldMask festgelegt werden. Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/choose-fields.

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

Gibt Vorhersagen für die angegebene Eingabe zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

Ein Foto-Medium mit einem Foto-Referenzstring abrufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

Rufen Sie die Details eines Orts anhand seines Ressourcennamens ab. Das ist ein String im Format places/{place_id}.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

Orte in der Nähe von Orten suchen

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

Ortssuche auf Grundlage von Textabfragen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

AddressDescriptor

Eine relationale Beschreibung eines Standorts. Enthält eine sortierte Liste mit nahegelegenen Sehenswürdigkeiten sowie genaue umschließende Gebiete und deren Beziehung zum Zielort.

Felder
landmarks[]

Landmark

Eine sortierte Liste von Sehenswürdigkeiten in der Nähe. Die bekanntesten und nächstgelegenen Sehenswürdigkeiten werden zuerst aufgeführt.

areas[]

Area

Eine sortierte Liste mit angrenzenden oder benachbarten Bereichen. Die am besten erkennbaren und präzisesten Bereiche werden zuerst aufgeführt.

Region

Informationen zum Gebiet und zur Beziehung des Gebiets zum Zielort.

„Areas“ umfasst genaue Unterorte, Stadtteile und große Anlagen, die zur Beschreibung eines Orts nützlich sind.

Felder
name

string

Der Ressourcenname des Bereichs.

place_id

string

Die Orts-ID des Gebiets.

display_name

LocalizedText

Der Anzeigename des Bereichs.

containment

Containment

Definiert die räumliche Beziehung zwischen dem Zielort und dem Gebiet.

Eindämmung

Definiert die räumliche Beziehung zwischen dem Zielort und dem Gebiet.

Enums
CONTAINMENT_UNSPECIFIED Die Eindämmung ist nicht angegeben.
WITHIN Der Zielstandort befindet sich in der Nähe des Zentrums der Region.
OUTSKIRTS Der Zielstandort befindet sich in der Region, in der sich das Gebiet befindet, in der Nähe des Rands.
NEAR Der Zielort liegt außerhalb der Region, aber in der Nähe.

Sehenswürdigkeit

Grundlegende Informationen zum Orientierungspunkt und seine Beziehung zum Zielort.

Wahrzeichen sind bekannte Orte, mit denen sich ein Standort beschreiben lässt.

Felder
name

string

Der Ressourcenname des Orientierungspunkts.

place_id

string

Die Orts-ID des Wahrzeichens.

display_name

LocalizedText

Der Anzeigename des Orientierungspunkts.

types[]

string

Eine Reihe von Typ-Tags für dieses Wahrzeichen. Eine vollständige Liste der möglichen Werte finden Sie unter https://developers.google.com/maps/documentation/places/web-service/place-types.

spatial_relationship

SpatialRelationship

Definiert die räumliche Beziehung zwischen dem Zielort und dem Orientierungspunkt.

straight_line_distance_meters

float

Die Luftlinie zwischen dem Mittelpunkt des Ziels und dem Mittelpunkt des Orientierungspunkts in Metern. In einigen Fällen kann dieser Wert länger als travel_distance_meters sein.

travel_distance_meters

float

Die Entfernung in Metern entlang des Straßennetzes vom Ziel zum Orientierungspunkt, sofern bekannt. Bei diesem Wert wird die Art der Fortbewegung nicht berücksichtigt, z. B. zu Fuß, mit dem Auto oder mit dem Fahrrad.

SpatialRelationship

Definiert die räumliche Beziehung zwischen dem Zielort und dem Orientierungspunkt.

Enums
NEAR Dies ist die Standardbeziehung, wenn nichts Spezifischeres unten zutrifft.
WITHIN Das Landmark hat eine räumliche Geometrie und das Ziel liegt innerhalb seiner Grenzen.
BESIDE Das Ziel liegt direkt neben dem Orientierungspunkt.
ACROSS_THE_ROAD Das Ziel befindet sich direkt gegenüber dem Orientierungspunkt auf der anderen Straßenseite.
DOWN_THE_ROAD Auf derselben Route wie das Wahrzeichen, aber nicht daneben oder gegenüber.
AROUND_THE_CORNER Nicht auf derselben Route wie das Wahrzeichen, aber nur eine Abzweigung entfernt.
BEHIND In der Nähe des Bauwerks, aber weiter entfernt von den Straßeneingängen.

AuthorAttribution

Informationen zum Autor der UGC-Daten. Verwendet in Photo und Review.

Felder
display_name

string

Der Name des Autors von Photo oder Review.

uri

string

URI des Autors der Photo oder Review.

photo_uri

string

Profilbild-URI des Autors von Photo oder Review.

AutocompletePlacesRequest

Anfrageprotokoll für AutocompletePlaces.

Felder
input

string

Erforderlich. Die Textzeichenfolge, nach der gesucht werden soll.

location_bias

LocationBias

Optional. Ergebnisse für einen bestimmten Ort höher gewichten

Es sollte höchstens eines von location_bias oder location_restriction festgelegt sein. Wenn beides nicht festgelegt ist, werden die Ergebnisse anhand der IP-Adresse gewichtet. Das bedeutet, dass die IP-Adresse einem ungenauen Standort zugeordnet und als Gewichtungssignal verwendet wird.

location_restriction

LocationRestriction

Optional. Suchergebnisse auf einen bestimmten Ort beschränken.

Es sollte höchstens eines von location_bias oder location_restriction festgelegt sein. Wenn beides nicht festgelegt ist, werden die Ergebnisse anhand der IP-Adresse gewichtet. Das bedeutet, dass die IP-Adresse einem ungenauen Standort zugeordnet und als Gewichtungssignal verwendet wird.

included_primary_types[]

string

Optional. Der primäre Ortstyp (z. B. „restaurant“ oder „gas_station“) ist in den Ortstypen (https://developers.google.com/maps/documentation/places/web-service/place-types) enthalten oder nur (regions) oder nur (cities). Ein Ort wird nur zurückgegeben, wenn sein primärer Typ in dieser Liste enthalten ist. Sie können bis zu fünf Werte angeben. Wenn keine Typen angegeben sind, werden alle Ortstypen zurückgegeben.

included_region_codes[]

string

Optional. Schließen Sie nur Ergebnisse in den angegebenen Regionen ein, die als bis zu 15 zweistellige CLDR-Regionencodes angegeben werden. Ein leeres Set schränkt die Ergebnisse nicht ein. Wenn sowohl location_restriction als auch included_region_codes festgelegt sind, befinden sich die Ergebnisse im Schnittbereich.

language_code

string

Optional. Die Sprache, in der die Ergebnisse zurückgegeben werden sollen. Die Standardeinstellung ist „en-US“. Die Ergebnisse können in verschiedenen Sprachen vorliegen, wenn die in input verwendete Sprache von language_code abweicht oder wenn für den zurückgegebenen Ort keine Übersetzung aus der lokalen Sprache in language_code vorhanden ist.

region_code

string

Optional. Der Regionscode, angegeben als zweistelliger CLDR-Regionscode. Dies wirkt sich auf die Adressformatierung und das Ranking der Ergebnisse aus und kann beeinflussen, welche Ergebnisse zurückgegeben werden. Die Ergebnisse werden dadurch nicht auf die angegebene Region beschränkt. Verwenden Sie region_code_restriction, um die Ergebnisse auf eine Region zu beschränken.

origin

LatLng

Optional. Der Ausgangspunkt, von dem aus die geodätische Entfernung zum Ziel berechnet wird (als distance_meters zurückgegeben). Wenn dieser Wert weggelassen wird, wird die geodätische Entfernung nicht zurückgegeben.

input_offset

int32

Optional. Ein nullbasiertes Unicode-Zeichen-Offset von input, das die Cursorposition in input angibt. Die Cursorposition kann sich darauf auswirken, welche Vorschläge zurückgegeben werden.

Wenn leer, wird standardmäßig die Länge von input verwendet.

include_query_predictions

bool

Optional. Wenn „true“, enthält die Antwort sowohl Orts- als auch Suchvorhersagen. Andernfalls werden in der Antwort nur Ortsvorschläge zurückgegeben.

session_token

string

Optional. Ein String, der eine Autocomplete-Sitzung zu Abrechnungszwecken identifiziert. Muss eine URL- und dateinamensichere Base64-codierte Zeichenfolge 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 Anmeldedaten, die für jede Anfrage innerhalb einer Sitzung verwendet werden, müssen zum selben Google Cloud Console-Projekt gehören. Sobald eine Sitzung beendet wird, ist das Token nicht mehr gültig. Ihre App muss für jede Sitzung ein neues Token generieren. Wenn Sie den session_token-Parameter weglassen oder ein Sitzungstoken wiederverwenden, wird die Sitzung so in Rechnung gestellt, als wäre kein Sitzungstoken bereitgestellt 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. Die Verwendung einer UUID der Version 4 wird empfohlen.
  • Achten Sie darauf, dass die Anmeldedaten, die für alle Place Autocomplete-, Place Details- und Address Validation-Anfragen innerhalb einer Sitzung verwendet werden, zum selben Cloud Console-Projekt gehören.
  • Für jede neue Sitzung muss ein eindeutiges Sitzungstoken weitergegeben werden. Wenn Sie dasselbe Token für mehr als eine Sitzung verwenden, wird jede Anfrage separat in Rechnung gestellt.
include_pure_service_area_businesses

bool

Optional. Schließt Unternehmen ohne festen Standort in einem Einzugsgebiet ein, wenn das Feld auf „true“ gesetzt ist. Ein reines Unternehmen ohne festen Standort in einem Einzugsgebiet ist ein Unternehmen, das Kunden vor Ort besucht oder einen Lieferservice hat, aber an seiner Geschäftsadresse keine Kunden empfängt. Dazu gehören z. B. Reinigungsfirmen oder Klempner. Diese Unternehmen haben keine physische Adresse oder keinen Standort bei Google Maps. Für diese Unternehmen werden von Places keine Felder wie location, plus_code und andere standortbezogene Felder zurückgegeben.

LocationBias

Die Region, in der gesucht werden soll. Die Ergebnisse können auf die angegebene Region ausgerichtet sein.

Felder

Union-Feld type.

Für type ist nur einer der folgenden Werte zulässig:

rectangle

Viewport

Ein Viewport, der durch eine Nordost- und eine Südwestecke definiert wird.

circle

Circle

Ein Kreis, der durch einen Mittelpunkt und einen Radius definiert wird.

LocationRestriction

Die Region, in der gesucht werden soll. Die Ergebnisse werden auf die angegebene Region beschränkt.

Felder

Union-Feld type.

Für type ist nur einer der folgenden Werte zulässig:

rectangle

Viewport

Ein Viewport, der durch eine Nordost- und eine Südwestecke definiert wird.

circle

Circle

Ein Kreis, der durch einen Mittelpunkt und einen Radius definiert wird.

AutocompletePlacesResponse

Antwort-Proto für AutocompletePlaces.

Felder
suggestions[]

Suggestion

Enthält eine Liste mit Vorschlägen, die in absteigender Reihenfolge nach Relevanz sortiert sind.

Vorschlag

Ein Ergebnis für einen Vorschlag für die automatische Vervollständigung.

Felder

Union-Feld kind.

Für kind ist nur einer der folgenden Werte zulässig:

place_prediction

PlacePrediction

Eine Vorhersage für einen Ort.

query_prediction

QueryPrediction

Eine Vorhersage für eine Anfrage.

FormattableText

Text, der eine Orts- oder Abfragevorhersage darstellt. Der Text kann unverändert verwendet oder formatiert werden.

Felder
text

string

Text, der unverändert verwendet oder mit matches formatiert werden kann.

matches[]

StringRange

Eine Liste von Stringbereichen, die angeben, wo die Eingabeanfrage in text übereinstimmt. Mit den Bereichen können Sie bestimmte Teile von text formatieren. Die Teilstrings stimmen möglicherweise nicht genau mit input überein, wenn die Übereinstimmung anhand anderer Kriterien als String-Abgleich ermittelt wurde, z. B. durch Rechtschreibkorrekturen oder Transliterationen.

Diese Werte sind Unicode-Zeichen-Offsets von text. Die Bereiche sind garantiert nach aufsteigenden Offsetwerten sortiert.

PlacePrediction

Vorhersageergebnisse für eine Place Autocomplete-Vorhersage.

Felder
place

string

Der Ressourcenname des vorgeschlagenen Orts. Dieser Name kann in anderen APIs verwendet werden, die Ortsnamen akzeptieren.

place_id

string

Die eindeutige Kennung des vorgeschlagenen Orts. Diese Kennung kann in anderen APIs verwendet werden, die Orts-IDs akzeptieren.

text

FormattableText

Enthält den für Menschen lesbaren Namen für das zurückgegebene Ergebnis. Bei Ergebnissen für Niederlassungen sind das in der Regel der Name und die Adresse des Unternehmens.

text wird für Entwickler empfohlen, die ein einzelnes UI-Element anzeigen möchten. Entwickler, die zwei separate, aber zusammengehörige UI-Elemente anzeigen möchten, sollten stattdessen structured_format verwenden. Es gibt zwei verschiedene Möglichkeiten, einen Ortsvorschlag darzustellen. Nutzer sollten nicht versuchen, structured_format in text zu parsen oder umgekehrt.

Dieser Text kann sich von dem display_name unterscheiden, der von GetPlace zurückgegeben wird.

Die Antwort kann in verschiedenen Sprachen verfasst sein, wenn die Anfrage input und language_code in verschiedenen Sprachen gestellt werden oder wenn für den Ort keine Übersetzung von der lokalen Sprache in language_code vorhanden ist.

structured_format

StructuredFormat

Eine Aufschlüsselung der Ortsvorhersage in Haupttext mit dem Namen des Orts und sekundären Text mit zusätzlichen Unterscheidungsmerkmalen wie einer Stadt oder Region.

structured_format wird für Entwickler empfohlen, die zwei separate, aber zusammengehörige UI-Elemente anzeigen möchten. Entwickler, die ein einzelnes UI-Element anzeigen möchten, sollten stattdessen text verwenden. Es gibt zwei verschiedene Möglichkeiten, einen Ortsvorschlag darzustellen. Nutzer sollten nicht versuchen, structured_format in text zu parsen oder umgekehrt.

types[]

string

Liste der Typen, die für diesen Ort aus Tabelle A oder Tabelle B unter https://developers.google.com/maps/documentation/places/web-service/place-types gelten.

Ein Typ ist eine Kategorisierung eines Orts. Orte mit gemeinsamen Typen haben ähnliche Merkmale.

distance_meters

int32

Die Länge der geodätischen Linie in Metern ab origin, falls origin angegeben ist. Bei bestimmten Vorhersagen wie Routen wird dieses Feld möglicherweise nicht ausgefüllt.

QueryPrediction

Vorhersageergebnisse für eine automatische Vervollständigung.

Felder
text

FormattableText

Der vorhergesagte Text. Dieser Text stellt keinen Ort dar, sondern eine Textanfrage, die in einem Such-Endpoint (z. B. Text Search) verwendet werden könnte.

text wird für Entwickler empfohlen, die ein einzelnes UI-Element anzeigen möchten. Entwickler, die zwei separate, aber zusammengehörige UI-Elemente anzeigen möchten, sollten stattdessen structured_format verwenden. Sie sind zwei verschiedene Möglichkeiten, eine Suchvorhersage darzustellen. Nutzer sollten nicht versuchen, structured_format in text zu parsen oder umgekehrt.

Die Antwort kann in verschiedenen Sprachen verfasst sein, wenn die Anfrage input und language_code in verschiedenen Sprachen formuliert sind oder wenn für einen Teil der Anfrage keine Übersetzung von der lokalen Sprache in language_code verfügbar ist.

structured_format

StructuredFormat

Eine Aufschlüsselung der Suchanfragevorhersage in Haupttext mit der Suchanfrage und sekundären Text mit zusätzlichen disambiguierenden Merkmalen (z. B. einer Stadt oder Region).

structured_format wird für Entwickler empfohlen, die zwei separate, aber zusammengehörige UI-Elemente anzeigen möchten. Entwickler, die ein einzelnes UI-Element anzeigen möchten, sollten stattdessen text verwenden. Sie sind zwei verschiedene Möglichkeiten, eine Suchvorhersage darzustellen. Nutzer sollten nicht versuchen, structured_format in text zu parsen oder umgekehrt.

StringRange

Identifiziert einen Teilstring in einem bestimmten Text.

Felder
start_offset

int32

Nullbasiertes Offset des ersten Unicode-Zeichens des Strings (einschließlich).

end_offset

int32

Nullbasierter Offset des letzten Unicode-Zeichens (exklusiv).

StructuredFormat

Enthält eine Aufschlüsselung eines Orts- oder Suchvorschlags in Haupt- und Sekundärtext.

Bei Ortsvorhersagen enthält der Haupttext den genauen Namen des Orts. Bei Vorhersagen für Abfragen enthält der Haupttext die Abfrage.

Der sekundäre Text enthält zusätzliche Informationen zur Unterscheidung (z. B. eine Stadt oder Region), um den Ort weiter zu identifizieren oder die Anfrage zu verfeinern.

Felder
main_text

FormattableText

Stellt den Namen des Orts oder der Anfrage dar.

secondary_text

FormattableText

Stellt zusätzliche disambiguierende Attribute (z. B. eine Stadt oder Region) dar, um den Ort weiter zu identifizieren oder die Anfrage zu verfeinern.

Kreis

Kreis mit einem LatLng als Mittelpunkt und Radius.

Felder
center

LatLng

Erforderlich. Breiten- und Längengrad für den Mittelpunkt

Der Breitengrad muss im Bereich [-90,0, 90,0] liegen. Der Bereich des Längengrads muss zwischen -180,0 und 180,0 liegen.

radius

double

Erforderlich. Radius in Metern. Der Radius muss im Bereich [0,0, 50.000,0] liegen.

ContentBlock

Ein Inhaltsblock, der einzeln ausgeliefert werden kann.

Felder
content

LocalizedText

Inhalte, die sich auf das Thema beziehen.

referenced_places[]

string

Die Liste der Ressourcennamen der referenzierten Orte. Dieser Name kann in anderen APIs verwendet werden, die Ressourcennamen für Orte akzeptieren.

ContextualContent

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Inhalte, die im Kontext der Ortsanfrage stehen.

Felder
reviews[]

Review

Liste der Rezensionen zu diesem Ort, die im Kontext der Ortsanfrage stehen.

photos[]

Photo

Informationen (einschließlich Referenzen) zu Fotos dieses Orts, die im Kontext der Ortsanfrage stehen.

justifications[]

Justification

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Begründungen für den Ort.

Begründung

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Begründungen für den Ort. Begründungen beantworten die Frage, warum ein Ort für einen Endnutzer interessant sein könnte.

Felder

Union-Feld justification.

Für justification ist nur einer der folgenden Werte zulässig:

review_justification

ReviewJustification

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

BusinessAvailabilityAttributesJustification

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Begründungen für BusinessAvailabilityAttributes. Hier werden einige Attribute eines Unternehmens angezeigt, die für einen Endnutzer von Interesse sein könnten.

Felder
takeout

bool

Ob ein Ort Gerichte zum Mitnehmen anbietet.

delivery

bool

Ob ein Lieferservice angeboten wird.

dine_in

bool

Ob der Verzehr von Speisen und Getränken vor Ort möglich ist.

ReviewJustification

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Begründungen für Nutzerrezensionen Damit wird ein Abschnitt der Nutzerrezension hervorgehoben, der für einen Endnutzer von Interesse sein könnte. Wenn die Suchanfrage beispielsweise „Pizza aus dem Holzofen“ lautet, wird in der Begründung der Rezension der Text hervorgehoben, der für die Suchanfrage relevant ist.

Felder
highlighted_text

HighlightedText

review

Review

Die Rezension, aus der der markierte Text generiert wurde.

HighlightedText

Der durch die Begründung hervorgehobene Text. Dies ist eine Teilmenge der Rezension selbst. Das genaue Wort, das hervorgehoben werden soll, wird durch HighlightedTextRange markiert. Im Text können mehrere Wörter hervorgehoben sein.

Felder
text

string

highlighted_text_ranges[]

HighlightedTextRange

Die Liste der Bereiche des hervorgehobenen Texts.

HighlightedTextRange

Der Bereich des hervorgehobenen Texts.

Felder
start_index

int32

end_index

int32

EVChargeOptions

Informationen zur Ladestation für Elektrofahrzeuge am Ort. Die Terminologie folgt https://afdc.energy.gov/fuels/electricity_infrastructure.html. An einem Port kann jeweils nur ein Auto aufgeladen werden. Ein Port hat einen oder mehrere Anschlüsse. Eine Station hat einen oder mehrere Anschlüsse.

Felder
connector_count

int32

Anzahl der Anschlüsse an dieser Ladestation. Da einige Anschlüsse jedoch mehrere Stecker haben können, aber jeweils nur ein Auto gleichzeitig geladen werden kann, kann die Anzahl der Stecker größer sein als die Gesamtzahl der Autos, die gleichzeitig geladen werden können.

connector_aggregation[]

ConnectorAggregation

Eine Liste von Aggregationen von Ladesteckern für Elektrofahrzeuge, die Steckverbinder desselben Typs und mit derselben Laderate enthalten.

ConnectorAggregation

Informationen zu Ladestationen für Elektrofahrzeuge, gruppiert nach [type, max_charge_rate_kw]. Hier sehen Sie die aggregierten Daten für Ladestationen mit demselben Typ und derselben maximalen Laderate in kW.

Felder
type

EVConnectorType

Der Connectortyp dieser Aggregation.

max_charge_rate_kw

double

Die statische maximale Laderate in kW für jeden Anschluss in der Aggregation.

count

int32

Anzahl der Connectors in dieser Aggregation.

availability_last_update_time

Timestamp

Der Zeitstempel, zu dem die Informationen zur Verfügbarkeit des Connectors in dieser Aggregation zuletzt aktualisiert wurden.

available_count

int32

Anzahl der Connectors in dieser Aggregation, die derzeit verfügbar sind.

out_of_service_count

int32

Anzahl der Connectors in dieser Aggregation, die derzeit nicht in Betrieb sind.

EVConnectorType

Weitere Informationen zu den Anschlusstypen für das Laden von Elektrofahrzeugen finden Sie unter http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107.

Enums
EV_CONNECTOR_TYPE_UNSPECIFIED Nicht angegebener Connector.
EV_CONNECTOR_TYPE_OTHER Andere Anschlusstypen
EV_CONNECTOR_TYPE_J1772 J1772-Stecker Typ 1
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 Typ 2-Anschluss Wird oft als MENNEKES bezeichnet.
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO-Anschluss
EV_CONNECTOR_TYPE_CCS_COMBO_1 Combined Charging System (Wechselstrom und Gleichstrom). Basierend auf SAE. J1772-Anschluss Typ 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Combined Charging System (Wechselstrom und Gleichstrom). Basierend auf dem Typ-2-Mennekes-Stecker
EV_CONNECTOR_TYPE_TESLA Der generische TESLA-Connector. In Nordamerika ist das NACS, in anderen Teilen der Welt kann es sich aber auch um einen anderen Standard handeln, z.B. CCS Combo 2 (CCS2) oder GB/T. Dieser Wert ist weniger repräsentativ für einen tatsächlichen Steckertyp und gibt eher an, ob ein Fahrzeug der Marke Tesla an einer Ladestation von Tesla geladen werden kann.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T Der GB/T-Typ entspricht dem GB/T-Standard in China. Dieser Typ umfasst alle GB_T-Typen.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Nicht angegebene Steckdose.
EV_CONNECTOR_TYPE_NACS Das North American Charging System (NACS), standardisiert als SAE J3400.

FuelOptions

Die neuesten Informationen zu den Kraftstoffoptionen an einer Tankstelle. Diese Informationen werden regelmäßig aktualisiert.

Felder
fuel_prices[]

FuelPrice

Der letzte bekannte Kraftstoffpreis für jede Kraftstoffart, die an dieser Tankstelle angeboten wird. Für jeden Kraftstofftyp, der an dieser Tankstelle verfügbar ist, gibt es einen Eintrag. Die Reihenfolge spielt keine Rolle.

FuelPrice

Informationen zum Kraftstoffpreis für einen bestimmten Typ.

Felder
type

FuelType

Der Kraftstofftyp.

price

Money

Der Preis des Kraftstoffs.

update_time

Timestamp

Der Zeitpunkt, zu dem der Kraftstoffpreis zuletzt aktualisiert wurde.

FuelType

Kraftstoffarten.

Enums
FUEL_TYPE_UNSPECIFIED Nicht angegebener Kraftstofftyp.
DIESEL Dieselkraftstoff
DIESEL_PLUS Diesel Plus-Kraftstoff.
REGULAR_UNLEADED Normalbenzin
MIDGRADE Super
PREMIUM Ein Premium-Phone –
SP91 SP 91.
SP91_E10 SP 91 E10
SP92 SP 92.
SP95 SP 95
SP95_E10 SP95 E10
SP98 SP 98.
SP99 SP 99.
SP100 SP 100
LPG Flüssiggas
E80 E 80.
E85 E 85.
E100 E 100.
METHANE Methan
BIO_DIESEL Biodiesel.
TRUCK_DIESEL Lkw-Diesel.

GetPhotoMediaRequest

Anfrage zum Abrufen eines Fotos eines Orts anhand des Namens der Fotoressource.

Felder
name

string

Erforderlich. Der Ressourcenname eines Fotomediums im Format places/{place_id}/photos/{photo_reference}/media.

Der Ressourcenname eines Fotos, der im Feld photos.name eines Place-Objekts zurückgegeben wird, hat das Format places/{place_id}/photos/{photo_reference}. Sie müssen /media an das Ende der Fotoressource anhängen, um den Namen der Fotoressource zu erhalten.

max_width_px

int32

Optional. Gibt die maximal gewünschte Breite des Bildes in Pixeln an. Wenn das Bild kleiner als die angegebenen Werte ist, wird das Originalbild zurückgegeben. Wenn das Bild in einer der beiden Dimensionen größer ist, wird es so skaliert, dass es der kleineren der beiden Dimensionen entspricht, wobei das ursprüngliche Seitenverhältnis beibehalten wird. Für die Attribute „max_height_px“ und „max_width_px“ ist eine Ganzzahl zwischen 1 und 4.800 (einschließlich) zulässig. Wenn der Wert nicht im zulässigen Bereich liegt, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Es muss mindestens einer der Werte „max_height_px“ oder „max_width_px“ angegeben werden. Wenn weder „max_height_px“ noch „max_width_px“ angegeben ist, wird der Fehler „INVALID_ARGUMENT“ zurückgegeben.

max_height_px

int32

Optional. Gibt die maximal gewünschte Höhe des Bildes in Pixeln an. Wenn das Bild kleiner als die angegebenen Werte ist, wird das Originalbild zurückgegeben. Wenn das Bild in einer der beiden Dimensionen größer ist, wird es so skaliert, dass es der kleineren der beiden Dimensionen entspricht, wobei das ursprüngliche Seitenverhältnis beibehalten wird. Für die Attribute „max_height_px“ und „max_width_px“ ist eine Ganzzahl zwischen 1 und 4.800 (einschließlich) zulässig. Wenn der Wert nicht im zulässigen Bereich liegt, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Es muss mindestens einer der Werte „max_height_px“ oder „max_width_px“ angegeben werden. Wenn weder „max_height_px“ noch „max_width_px“ angegeben ist, wird der Fehler „INVALID_ARGUMENT“ zurückgegeben.

skip_http_redirect

bool

Optional. Wenn diese Option festgelegt ist, wird das standardmäßige HTTP-Weiterleitungsverhalten übersprungen und eine Antwort im Textformat gerendert (z. B. im JSON-Format für den HTTP-Anwendungsfall). Wenn nicht festgelegt, wird eine HTTP-Weiterleitung ausgegeben, um den Aufruf an die Bildmedien weiterzuleiten. Diese Option wird für Nicht-HTTP-Anfragen ignoriert.

GetPlaceRequest

Anfrage zum Abrufen eines Orts anhand seines Ressourcennamens, der ein String im Format places/{place_id} ist.

Felder
name

string

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

language_code

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.

region_code

string

Optional. Der Länder-/Regionscode (CLDR) des Standorts, von dem die Anfrage stammt, im Unicode-Format. Mit diesem Parameter werden die Ortsdetails angezeigt, z. B. der regionsspezifische Ortsname, sofern verfügbar. Der Parameter kann sich je nach anwendbarem Recht auf die Ergebnisse auswirken. Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Hinweis: Dreistellige Ländercodes werden derzeit nicht unterstützt.

session_token

string

Optional. Ein String, der eine Autocomplete-Sitzung zu Abrechnungszwecken identifiziert. Muss eine URL- und dateinamensichere Base64-codierte Zeichenfolge 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 Anmeldedaten, die für jede Anfrage innerhalb einer Sitzung verwendet werden, müssen zum selben Google Cloud Console-Projekt gehören. Sobald eine Sitzung beendet wird, ist das Token nicht mehr gültig. Ihre App muss für jede Sitzung ein neues Token generieren. Wenn Sie den session_token-Parameter weglassen oder ein Sitzungstoken wiederverwenden, wird die Sitzung so in Rechnung gestellt, als wäre kein Sitzungstoken bereitgestellt 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. Die Verwendung einer UUID der Version 4 wird empfohlen.
  • Achten Sie darauf, dass die Anmeldedaten, die für alle Place Autocomplete-, Place Details- und Address Validation-Anfragen innerhalb einer Sitzung verwendet werden, zum selben Cloud Console-Projekt gehören.
  • Für jede neue Sitzung muss ein eindeutiges Sitzungstoken weitergegeben werden. Wenn Sie dasselbe Token für mehr als eine Sitzung verwenden, wird jede Anfrage separat in Rechnung gestellt.

Foto

Informationen zu einem Foto eines Orts.

Felder
name

string

ID. Eine Referenz, die dieses Ortsfoto repräsentiert und mit der dieses Ortsfoto noch einmal aufgerufen werden kann (auch API-Ressourcenname genannt: places/{place_id}/photos/{photo}).

width_px

int32

Die maximal verfügbare Breite in Pixeln.

height_px

int32

Die maximal verfügbare Höhe in Pixeln.

author_attributions[]

AuthorAttribution

Die Autoren dieses Fotos.

flag_content_uri

string

Ein Link, über den Nutzer ein Problem mit dem Foto melden können.

google_maps_uri

string

Ein Link zum Anzeigen des Fotos auf Google Maps.

PhotoMedia

Ein Medienobjekt vom Typ „Foto“ aus der Places API.

Felder
name

string

Der Ressourcenname eines Fotomediums im Format places/{place_id}/photos/{photo_reference}/media.

photo_uri

string

Ein kurzlebiger URI, der zum Rendern des Fotos verwendet werden kann.

Ort

Alle Informationen, die einen Ort repräsentieren.

Felder
name

string

Der Ressourcenname dieses Orts im Format places/{place_id}. Kann verwendet werden, um den Ort zu suchen.

id

string

Die eindeutige Kennung eines Orts.

display_name

LocalizedText

Der lokalisierte Name des Orts, der sich als kurze menschenlesbare Beschreibung eignet. Beispiele: „Google Sydney“, „Starbucks“, „Pyrmont“ usw.

types[]

string

Eine Reihe von Typ-Tags für dieses Ergebnis. Beispiel: „political“ und „locality“. Eine vollständige Liste der möglichen Werte finden Sie in Tabelle A und Tabelle B unter https://developers.google.com/maps/documentation/places/web-service/place-types.

primary_type

string

Der primäre Typ des angegebenen Ergebnisses. Dieser Typ muss einer der von der Places API unterstützten Typen sein. Beispiele: „Restaurant“, „Café“, „Flughafen“ usw. Ein Ort kann nur einen primären Typ haben. Eine vollständige Liste der möglichen Werte finden Sie in Tabelle A und Tabelle B unter https://developers.google.com/maps/documentation/places/web-service/place-types. Der primäre Typ fehlt möglicherweise, wenn der primäre Typ des Orts nicht unterstützt wird. Wenn ein primärer Typ vorhanden ist, ist er immer einer der Typen im Feld types.

primary_type_display_name

LocalizedText

Der angezeigte Name des primären Typs, sofern zutreffend in der Sprache der Anfrage lokalisiert. Eine vollständige Liste der möglichen Werte finden Sie in Tabelle A und Tabelle B unter https://developers.google.com/maps/documentation/places/web-service/place-types. Der primäre Typ fehlt möglicherweise, wenn der primäre Typ des Orts nicht unterstützt wird.

national_phone_number

string

Eine für Menschen lesbare Telefonnummer für den Ort im nationalen Format.

international_phone_number

string

Eine lesbare Telefonnummer für den Ort im internationalen Format.

formatted_address

string

Eine vollständige, für Menschen lesbare Adresse für diesen Ort.

short_formatted_address

string

Eine kurze, für Menschen lesbare Adresse für diesen Ort.

postal_address

PostalAddress

Die Adresse im Format einer Postadresse.

address_components[]

AddressComponent

Wiederholte Komponenten für jede Lokalitätsebene. Hinweise zum Array „address_components[]“: - Das Array der Adresskomponenten kann mehr Komponenten als nur „formatted_address“ enthalten. – Das Array enthält nicht unbedingt alle politischen Einheiten einer Adresse. Ausgenommen hiervon sind die in „formatted_address“ enthaltenen. Wenn Sie alle politischen Einheiten abrufen möchten, die zu einer bestimmten Adresse gehören, müssen Sie die umgekehrte Geocodierung verwenden. Dabei wird der Breiten-/Längengrad der Adresse als Parameter an die Anfrage übergeben. – Es kann nicht garantiert werden, dass das Antwortformat zwischen mehreren Anfragen gleich bleibt. Insbesondere die Anzahl der address_components variiert je nach angeforderter Adresse und kann sich im Laufe der Zeit für dieselbe Adresse ändern. Die Position einer Komponente im Array ändert sich unter Umständen. Auch der Typ der Komponente kann sich ändern. In einer späteren Anfrage fehlt evtl. auch eine bestimmte Komponente.

plus_code

PlusCode

Plus Code für den Breiten-/Längengrad des Orts.

location

LatLng

Die Position dieses Orts.

viewport

Viewport

Ein Darstellungsbereich, der sich für die Anzeige des Orts auf einer Karte mittlerer Größe eignet. Dieser Ausschnitt sollte nicht als physische Grenze oder Einzugsgebiet des Unternehmens verwendet werden.

rating

double

Eine Bewertung zwischen 1,0 und 5,0, die auf Nutzerrezensionen dieses Orts basiert.

google_maps_uri

string

Eine URL mit weiteren Informationen zu diesem Ort.

website_uri

string

Die offizielle Website des Ortes, z.B. die Homepage eines Unternehmens. Bei Orten, die Teil einer Kette sind (z.B. ein IKEA-Geschäft), ist das in der Regel die Website des einzelnen Geschäfts und nicht die der gesamten Kette.

reviews[]

Review

Liste der Rezensionen zu diesem Ort, sortiert nach Relevanz. Es können maximal fünf Rezensionen zurückgegeben werden.

regular_opening_hours

OpeningHours

Die regulären Öffnungszeiten. Wenn ein Ort durchgängig geöffnet ist (24 Stunden), wird das Feld close nicht festgelegt. Clients können sich darauf verlassen, dass „immer geöffnet“ (24 Stunden) als open-Zeitraum mit day mit dem Wert 0, hour mit dem Wert 0 und minute mit dem Wert 0 dargestellt wird.

time_zone

TimeZone

Zeitzone aus der IANA-Zeitzonendatenbank. Beispiel: „America/New_York“.

photos[]

Photo

Informationen (einschließlich Referenzen) zu Fotos dieses Orts. Es können maximal 10 Fotos zurückgegeben werden.

adr_format_address

string

Die Adresse des Orts im ADR-Mikroformat: http://microformats.org/wiki/adr.

business_status

BusinessStatus

Der Unternehmensstatus für den Ort.

price_level

PriceLevel

Preisniveau des Orts.

attributions[]

Attribution

Eine Reihe von Datenanbietern, die mit diesem Ergebnis angezeigt werden müssen.

icon_mask_base_uri

string

Eine gekürzte URL zu einer Symbolmaske. Nutzer können auf verschiedene Symboltypen zugreifen, indem sie ein Typsuffix an das Ende anhängen, z. B. „.svg“ oder „.png“.

icon_background_color

string

Hintergrundfarbe für „icon_mask“ im Hex-Format, z.B. #909CE1.

current_opening_hours

OpeningHours

Die Öffnungszeiten für die nächsten sieben Tage (einschließlich heute). Der Zeitraum beginnt am Tag der Anfrage um Mitternacht und endet sechs Tage später um 23:59 Uhr. Dieses Feld enthält das Unterfeld „special_days“ aller Öffnungszeiten, die für Daten mit besonderen Öffnungszeiten festgelegt sind.

current_secondary_opening_hours[]

OpeningHours

Enthält ein Array von Einträgen für die nächsten sieben Tage, einschließlich Informationen zu den sekundären Öffnungszeiten eines Unternehmens. Die sekundären Öffnungszeiten unterscheiden sich von den regulären Öffnungszeiten eines Unternehmens. Ein Restaurant kann beispielsweise die Öffnungszeiten des Drive-through-Schalters oder die Lieferzeiten als sekundäre Öffnungszeiten angeben. In diesem Feld wird das Unterfeld „type“ ausgefüllt. Es basiert auf einer vordefinierten Liste von Öffnungszeiten-Typen (z. B. DRIVE_THROUGH, PICKUP oder TAKEOUT) und den Typen des Orts. Dieses Feld enthält das Unterfeld „special_days“ aller Öffnungszeiten, die für Daten mit besonderen Öffnungszeiten festgelegt sind.

regular_secondary_opening_hours[]

OpeningHours

Enthält ein Array von Einträgen mit Informationen zu den regulären sekundären Öffnungszeiten eines Unternehmens. Die sekundären Öffnungszeiten unterscheiden sich von den regulären Öffnungszeiten eines Unternehmens. Ein Restaurant kann beispielsweise die Öffnungszeiten des Drive-through-Schalters oder die Lieferzeiten als sekundäre Öffnungszeiten angeben. In diesem Feld wird das Unterfeld „type“ ausgefüllt. Es basiert auf einer vordefinierten Liste von Öffnungszeiten-Typen (z. B. DRIVE_THROUGH, PICKUP oder TAKEOUT) und den Typen des Orts.

editorial_summary

LocalizedText

Enthält eine Zusammenfassung des Orts. Eine Zusammenfassung besteht aus einer textlichen Übersicht und enthält gegebenenfalls auch den Sprachcode. Der Zusammenfassungstext muss unverändert präsentiert werden und darf nicht geändert oder angepasst werden.

payment_options

PaymentOptions

Zahlungsoptionen, die an diesem Ort akzeptiert werden. Wenn keine Daten für eine Zahlungsoption verfügbar sind, wird das Feld für die Zahlungsoption nicht festgelegt.

parking_options

ParkingOptions

Parkmöglichkeiten, die vom Ort angeboten werden.

sub_destinations[]

SubDestination

Eine Liste von Unterzielen, die mit dem Ort verknüpft sind.

fuel_options

FuelOptions

Die neuesten Informationen zu den Kraftstoffoptionen an einer Tankstelle. Diese Informationen werden regelmäßig aktualisiert.

ev_charge_options

EVChargeOptions

Informationen zu Ladeoptionen für Elektrofahrzeuge.

generative_summary

GenerativeSummary

KI‑generierte Zusammenfassung des Orts.

containing_places[]

ContainingPlace

Liste der Orte, an denen sich der aktuelle Ort befindet.

address_descriptor

AddressDescriptor

Der Adressdeskriptor des Orts. Adressdeskriptoren enthalten zusätzliche Informationen, mit denen ein Ort anhand von Sehenswürdigkeiten und Gebieten beschrieben werden kann. Informationen zur regionalen Abdeckung von Adressdeskriptoren finden Sie unter https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.

price_range

PriceRange

Die Preisspanne, die mit einem Ort verknüpft ist.

review_summary

ReviewSummary

KI‑generierte Zusammenfassung des Orts anhand von Nutzerrezensionen.

ev_charge_amenity_summary

EvChargeAmenitySummary

Die Zusammenfassung der Einrichtungen in der Nähe der Ladestation für Elektrofahrzeuge.

neighborhood_summary

NeighborhoodSummary

Eine Zusammenfassung der Sehenswürdigkeiten in der Nähe des Orts.

consumer_alert

ConsumerAlert

Die Verbraucherwarnung für den Ort, wenn wir verdächtige Aktivitäten im Zusammenhang mit Unternehmensrezensionen bemerken oder ein Unternehmen gegen unsere Richtlinien verstößt.

utc_offset_minutes

int32

Anzahl der Minuten, um die die Zeitzone dieses Orts derzeit von UTC abweicht. Die Zeit wird in Minuten angegeben, um Zeitzonen zu unterstützen, die um Bruchteile einer Stunde verschoben sind, z.B. X Stunden und 15 Minuten.

user_rating_count

int32

Die Gesamtzahl der Rezensionen (mit oder ohne Text) für diesen Ort.

takeout

bool

Gibt an, ob das Unternehmen Essen zum Mitnehmen anbietet.

delivery

bool

Gibt an, ob das Unternehmen einen Lieferservice anbietet.

dine_in

bool

Gibt an, ob das Unternehmen Sitzplätze im Innen- oder Außenbereich anbietet.

curbside_pickup

bool

Gibt an, ob das Unternehmen die Abholung vor dem Geschäft unterstützt.

reservable

bool

Gibt an, ob für den Ort Reservierungen möglich sind.

serves_breakfast

bool

Gibt an, ob an diesem Ort Frühstück serviert wird.

serves_lunch

bool

Gibt an, ob an diesem Ort Mittagessen serviert wird.

serves_dinner

bool

Gibt an, ob an diesem Ort Abendessen serviert wird.

serves_beer

bool

Gibt an, ob an diesem Ort Bier ausgeschenkt wird.

serves_wine

bool

Gibt an, ob an diesem Ort Wein ausgeschenkt wird.

serves_brunch

bool

Gibt an, ob an diesem Ort Brunch angeboten wird.

serves_vegetarian_food

bool

Gibt an, ob an diesem Ort vegetarische Speisen serviert werden.

outdoor_seating

bool

Es gibt Sitzgelegenheiten im Freien.

live_music

bool

Hier gibt es Livemusik.

menu_for_children

bool

Es gibt eine Speisekarte für Kinder.

serves_cocktails

bool

Hier werden Cocktails serviert.

serves_dessert

bool

Hier wird Dessert serviert.

serves_coffee

bool

Hier wird Kaffee serviert.

good_for_children

bool

Der Ort ist gut für Kinder geeignet.

allows_dogs

bool

Hunde sind erlaubt.

restroom

bool

WC vorhanden

good_for_groups

bool

Die Unterkunft bietet Platz für Gruppen.

good_for_watching_sports

bool

Der Ort eignet sich für Sportübertragungen.

accessibility_options

AccessibilityOptions

Informationen zu den Optionen für Barrierefreiheit, die ein Ort bietet.

pure_service_area_business

bool

Gibt an, ob es sich bei dem Ort um ein Unternehmen ohne festen Standort in einem Einzugsgebiet handelt. Ein reines Unternehmen ohne festen Standort in einem Einzugsgebiet ist ein Unternehmen, das Kunden vor Ort besucht oder einen Lieferservice hat, aber an seiner Geschäftsadresse keine Kunden empfängt. Dazu gehören z. B. Reinigungsfirmen oder Klempner. Diese Unternehmen haben möglicherweise keine physische Adresse oder keinen Standort auf Google Maps.

AccessibilityOptions

Informationen zu den Optionen für Barrierefreiheit, die ein Ort bietet.

Felder
wheelchair_accessible_parking

bool

Der Ort bietet rollstuhlgerechte Parkplätze.

wheelchair_accessible_entrance

bool

Orte mit rollstuhlgerechtem Eingang.

wheelchair_accessible_restroom

bool

Rollstuhlgerechtes WC vorhanden

wheelchair_accessible_seating

bool

Der Ort verfügt über rollstuhlgerechte Sitzplätze.

AddressComponent

Die strukturierten Komponenten, aus denen die formatierte Adresse besteht, sofern diese Informationen verfügbar sind.

Felder
long_text

string

Die Volltextbeschreibung oder der Name der Adresskomponente. Beispielsweise könnte eine Adresskomponente für das Land Australien den long_name „Australia“ haben.

short_text

string

Ein abgekürzter Textname für die Adresskomponente, falls vorhanden. Beispielsweise könnte eine Adresskomponente für das Land Australien den short_name „AU“ haben.

types[]

string

Ein Array, das den oder die Typen der Adresskomponente angibt.

language_code

string

Die Sprache, die zum Formatieren dieser Komponenten verwendet wird, in CLDR-Notation.

Attribution

Informationen zu den Datenanbietern dieses Orts.

Felder
provider

string

Name des Datenanbieters des Orts.

provider_uri

string

URI des Datenanbieters des Orts.

BusinessStatus

Der Unternehmensstatus für den Ort.

Enums
BUSINESS_STATUS_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
OPERATIONAL Das Unternehmen ist in Betrieb, aber nicht unbedingt jetzt geöffnet.
CLOSED_TEMPORARILY Das Unternehmen ist vorübergehend geschlossen.
CLOSED_PERMANENTLY Das Geschäft ist dauerhaft geschlossen.

ConsumerAlert

Die Verbraucherwarnung für den Ort, wenn wir verdächtige Aktivitäten im Zusammenhang mit Unternehmensrezensionen bemerken oder ein Unternehmen gegen unsere Richtlinien verstößt.

Felder
overview

string

Die Übersicht der Warnmeldung für Nutzer.

details

Details

Die Details der Warnmeldung für Nutzer.ƒ

language_code

string

Der Sprachcode der Verbraucherwarnung. Dies ist ein BCP 47-Sprachcode.

Details

Details zur Warnmeldung für Nutzer.

Felder
title

string

Der Titel, der zusammen mit der Beschreibung angezeigt werden soll.

description

string

Die Beschreibung der Verbraucherwarnmeldung.

ContainingPlace

Informationen zum Ort, an dem sich dieser Ort befindet.

Felder
name

string

Der Ressourcenname des Orts, an dem sich dieser Ort befindet.

id

string

Die Orts-ID des Orts, an dem sich dieser Ort befindet.

EvChargeAmenitySummary

Die Zusammenfassung der Einrichtungen in der Nähe der Ladestation für Elektrofahrzeuge. Dies gilt nur für Orte vom Typ electric_vehicle_charging_station. Das Feld overview ist garantiert, die anderen Felder sind optional.

Felder
overview

ContentBlock

Eine Übersicht über die verfügbaren Ausstattungsmerkmale. Diese Informationen werden auf jeden Fall bereitgestellt.

coffee

ContentBlock

Eine Zusammenfassung der Kaffeemöglichkeiten in der Nähe.

restaurant

ContentBlock

Eine Zusammenfassung der Restaurants in der Nähe.

store

ContentBlock

Eine Zusammenfassung der Geschäfte in der Nähe.

flag_content_uri

string

Ein Link, über den Nutzer ein Problem mit der Zusammenfassung melden können.

disclosure_text

LocalizedText

Die KI-Offenlegungsmeldung „Zusammengefasst mit Gemini“ (und ihre lokalisierten Varianten). Die Antwort wird in der in der Anfrage angegebenen Sprache verfasst, sofern verfügbar.

GenerativeSummary

KI‑generierte Zusammenfassung des Orts.

Felder
overview

LocalizedText

Die Übersicht des Orts.

overview_flag_content_uri

string

Ein Link, über den Nutzer ein Problem mit der Übersichtszusammenfassung melden können.

disclosure_text

LocalizedText

Die KI-Offenlegungsmeldung „Zusammengefasst mit Gemini“ (und ihre lokalisierten Varianten). Die Antwort wird in der in der Anfrage angegebenen Sprache verfasst, sofern verfügbar.

NeighborhoodSummary

Eine Zusammenfassung der Sehenswürdigkeiten in der Nähe des Orts.

Felder
overview

ContentBlock

Eine Übersicht über die Nachbarschaft.

description

ContentBlock

Eine detaillierte Beschreibung der Nachbarschaft.

flag_content_uri

string

Ein Link, über den Nutzer ein Problem mit der Zusammenfassung melden können.

disclosure_text

LocalizedText

Die KI-Offenlegungsmeldung „Zusammengefasst mit Gemini“ (und ihre lokalisierten Varianten). Die Antwort wird in der in der Anfrage angegebenen Sprache verfasst, sofern verfügbar.

OpeningHours

Informationen zu den Öffnungszeiten des Orts.

Felder
periods[]

Period

Die Zeiträume, in denen dieser Ort in der Woche geöffnet ist. Die Zeiträume sind in chronologischer Reihenfolge in der Zeitzone des Ortes angegeben. Ein leerer (aber nicht fehlender) Wert gibt einen Ort an, der nie geöffnet ist, z.B. weil er vorübergehend wegen Renovierungsarbeiten geschlossen ist.

Der Starttag von periods ist NICHT festgelegt und sollte nicht als Sonntag angenommen werden. Der Starttag wird von der API anhand verschiedener Faktoren bestimmt. Bei einem Unternehmen, das rund um die Uhr geöffnet ist, kann der erste Zeitraum beispielsweise am Tag der Anfrage beginnen. Für andere Unternehmen ist es möglicherweise der erste Tag der Woche, an dem sie geöffnet sind.

HINWEIS: Die Reihenfolge des periods-Arrays ist unabhängig von der Reihenfolge des weekday_descriptions-Arrays. Gehen Sie nicht davon aus, dass sie am selben Tag beginnen.

weekday_descriptions[]

string

Lokalisierte Strings, die die Öffnungszeiten dieses Orts beschreiben, ein String für jeden Wochentag.

HINWEIS: Die Reihenfolge der Tage und der Wochenbeginn werden durch das Gebietsschema (Sprache und Region) bestimmt. Die Reihenfolge des periods-Arrays ist unabhängig von der Reihenfolge des weekday_descriptions-Arrays. Gehen Sie nicht davon aus, dass sie am selben Tag beginnen.

Ist leer, wenn die Öffnungszeiten unbekannt sind oder nicht in lokalisierten Text konvertiert werden konnten. Beispiel: „So: 18:00–06:00“

secondary_hours_type

SecondaryHoursType

Ein Typstring zur Identifizierung des Typs der sekundären Öffnungszeiten.

special_days[]

SpecialDay

Strukturierte Informationen für besondere Tage, die in den Zeitraum fallen, für den die zurückgegebenen Öffnungszeiten gelten. Besondere Tage sind Tage, die sich auf die Öffnungszeiten eines Orts auswirken können, z.B. Weihnachten. Legen Sie „current_opening_hours“ und „current_secondary_opening_hours“ fest, wenn es abweichende Öffnungszeiten gibt.

next_open_time

Timestamp

Das nächste Mal, wenn der aktuelle Zeitraum für die Öffnungszeiten beginnt, ist in bis zu 7 Tagen. Dieses Feld wird nur ausgefüllt, wenn der Zeitraum der Öffnungszeiten zum Zeitpunkt der Bearbeitung der Anfrage nicht aktiv ist.

next_close_time

Timestamp

Das nächste Mal, wenn der aktuelle Zeitraum für die Öffnungszeiten endet, ist in bis zu 7 Tagen. Dieses Feld wird nur ausgefüllt, wenn der Zeitraum der Öffnungszeiten zum Zeitpunkt der Bearbeitung der Anfrage aktiv ist.

open_now

bool

Gibt an, ob der Zeitraum der Öffnungszeiten derzeit aktiv ist. Bei regulären und aktuellen Öffnungszeiten gibt dieses Feld an, ob der Ort geöffnet ist. Bei sekundären Öffnungszeiten und aktuellen sekundären Öffnungszeiten gibt dieses Feld an, ob die sekundären Öffnungszeiten dieses Orts aktiv sind.

Zeitraum

Ein Zeitraum, in dem der Ort den Status „open_now“ beibehält.

Felder
open

Point

Die Uhrzeit, zu der der Ort geöffnet wird.

close

Point

Der Zeitpunkt, zu dem der Ort geschlossen wird.

Punkt

Punkte, an denen sich der Status ändert.

Felder
date

Date

Datum in der lokalen Zeitzone des Orts.

truncated

bool

Gibt an, ob dieser Endpunkt gekürzt wurde. Eine Kürzung erfolgt, wenn die tatsächlichen Öffnungszeiten außerhalb des Zeitraums liegen, für den wir Öffnungszeiten zurückgeben möchten. In diesem Fall werden die Öffnungszeiten auf diese Grenzen gekürzt. So werden maximal 24 * 7 Stunden ab Mitternacht des Tages der Anfrage zurückgegeben.

day

int32

Ein Wochentag als Ganzzahl im Bereich von 0 bis 6. 0 ist Sonntag, 1 ist Montag usw.

hour

int32

Die Stunde im 24‑Stunden-Format. Liegt im Bereich von 0 bis 23.

minute

int32

Die Minute. Liegt im Bereich von 0 bis 59.

SecondaryHoursType

Ein Typ, der zur Identifizierung des Typs der sekundären Öffnungszeiten verwendet wird.

Enums
SECONDARY_HOURS_TYPE_UNSPECIFIED Standardwert, wenn der sekundäre Stundentyp nicht angegeben ist.
DRIVE_THROUGH Die Drive-through-Öffnungszeiten für Banken, Restaurants oder Apotheken.
HAPPY_HOUR Die Happy Hour.
DELIVERY Die Lieferstunde.
TAKEOUT Die Abholzeit.
KITCHEN Die Küchenstunde.
BREAKFAST Die Frühstückszeit.
LUNCH Die Mittagspause.
DINNER Die Abendessenszeit.
BRUNCH Die Brunch-Stunde.
PICKUP Die Abholzeit.
ACCESS Die Zugriffszeiten für Lagerorte.
SENIOR_HOURS Die speziellen Öffnungszeiten für Senioren.
ONLINE_SERVICE_HOURS Die Online-Geschäftszeiten.

SpecialDay

Strukturierte Informationen für besondere Tage, die in den Zeitraum fallen, für den die zurückgegebenen Öffnungszeiten gelten. Besondere Tage sind Tage, die sich auf die Öffnungszeiten eines Orts auswirken können, z.B. Weihnachten.

Felder
date

Date

Das Datum dieses besonderen Tages.

ParkingOptions

Informationen zu Parkmöglichkeiten für den Ort. Ein Parkplatz kann mehrere Optionen gleichzeitig unterstützen.

Felder
free_parking_lot

bool

Parkplätze stehen kostenlos zur Verfügung.

paid_parking_lot

bool

Gebührenpflichtige Parkplätze sind vorhanden.

free_street_parking

bool

Kostenlose Parkplätze an der Straße sind vorhanden.

paid_street_parking

bool

Gebührenpflichtige Parkplätze an der Straße sind vorhanden.

valet_parking

bool

Ein Einparkservice ist verfügbar.

free_garage_parking

bool

Kostenlose Garagenparkplätze sind vorhanden.

paid_garage_parking

bool

Gebührenpflichtige Garagenparkplätze sind vorhanden.

PaymentOptions

Zahlungsoptionen, die an diesem Ort akzeptiert werden.

Felder
accepts_credit_cards

bool

Kreditkarten werden als Zahlungsmittel akzeptiert.

accepts_debit_cards

bool

An diesem Ort werden Debitkarten als Zahlungsmittel akzeptiert.

accepts_cash_only

bool

An diesem Ort wird nur Barzahlung akzeptiert. An Orten mit diesem Attribut werden möglicherweise auch andere Zahlungsmethoden akzeptiert.

accepts_nfc

bool

Hier werden NFC-Zahlungen akzeptiert.

PlusCode

Der Plus Code (http://plus.codes) ist ein Standortverweis mit zwei Formaten: einem globalen Code, der ein Rechteck von 14 m × 14 m (1/8.000stel eines Grades) oder kleiner definiert, und einem zusammengesetzten Code, bei dem das Präfix durch einen Referenzstandort ersetzt wird.

Felder
global_code

string

Der globale (vollständige) Code des Orts, z. B. „9FWM33GV+HQ“, der einen Bereich von 1/8.000 × 1/8.000 Grad (~14 × 14 Meter) darstellt.

compound_code

string

Der zusammengesetzte Code des Orts, z. B. „33GV+HQ, Ramberg, Norwegen“, der das Suffix des globalen Codes enthält und das Präfix durch einen formatierten Namen einer Referenzentität ersetzt.

ReviewSummary

KI‑generierte Zusammenfassung des Orts anhand von Nutzerrezensionen.

Felder
text

LocalizedText

Zusammenfassung der Nutzerrezensionen

flag_content_uri

string

Ein Link, über den Nutzer ein Problem mit der Zusammenfassung melden können.

disclosure_text

LocalizedText

Die KI-Offenlegungsmeldung „Zusammengefasst mit Gemini“ (und ihre lokalisierten Varianten). Die Antwort wird in der in der Anfrage angegebenen Sprache verfasst, sofern verfügbar.

reviews_uri

string

Ein Link, über den Sie Rezensionen zu diesem Ort in Google Maps aufrufen können.

SubDestination

Unterziele sind bestimmte Orte, die mit einem Hauptort verknüpft sind. Sie bieten Nutzern, die an einem großen oder komplexen Ort wie einem Flughafen, Nationalpark, einer Universität oder einem Stadion suchen, genauere Ziele. Unterziele an einem Flughafen können beispielsweise zugehörige Terminals und Parkplätze sein. Für untergeordnete Ziele werden die Orts-ID und der Ressourcenname des Orts zurückgegeben. Diese können in nachfolgenden Place Details (New)-Anfragen verwendet werden, um umfassendere Details abzurufen, darunter den Anzeigenamen und den Standort des untergeordneten Ziels.

Felder
name

string

Der Ressourcenname des untergeordneten Ziels.

id

string

Die Orts-ID des untergeordneten Ziels.

Polyline

Eine Routen-Polylinie. Es wird nur eine codierte Polylinie unterstützt, die als String übergeben werden kann und eine Komprimierung mit minimalem Verlust beinhaltet. Dies ist die Standardausgabe der Routes API.

Felder
Union-Feld polyline_type. Kapselt den Typ des Linienzugs ein. Die Standardausgabe der Routes API ist encoded_polyline. Für polyline_type ist nur einer der folgenden Werte zulässig:
encoded_polyline

string

Eine codierte Polylinie, die standardmäßig von der Routes API zurückgegeben wird. Encoder- und Decoder-Tools

PriceLevel

Preisniveau des Orts.

Enums
PRICE_LEVEL_UNSPECIFIED Die Preisstufe des Orts ist nicht angegeben oder unbekannt.
PRICE_LEVEL_FREE Der Ort bietet kostenlose Dienstleistungen an.
PRICE_LEVEL_INEXPENSIVE Hier werden günstige Dienstleistungen angeboten.
PRICE_LEVEL_MODERATE Hier werden Dienstleistungen zu einem angemessenen Preis angeboten.
PRICE_LEVEL_EXPENSIVE Hier werden teure Dienstleistungen angeboten.
PRICE_LEVEL_VERY_EXPENSIVE Der Ort bietet sehr teure Dienstleistungen an.

PriceRange

Die Preisspanne, die mit einem Ort verknüpft ist. end_price kann nicht festgelegt sein, was auf einen Bereich ohne Obergrenze hinweist (z.B. „Mehr als 100 $“).

Felder
start_price

Money

Das untere Ende der Preisspanne (einschließlich). Der Preis sollte mindestens diesem Betrag entsprechen.

end_price

Money

Das obere Ende der Preisspanne (exklusiv). Der Preis sollte niedriger als dieser Betrag sein.

Überprüfen

Informationen zu einer Rezension eines Orts.

Felder
name

string

Eine Referenz, die diese Rezension für einen Ort repräsentiert und mit der diese Rezension für einen Ort noch einmal aufgerufen werden kann (auch API-Ressourcenname genannt: places/{place_id}/reviews/{review}).

relative_publish_time_description

string

Ein String mit der formatierten letzten Zeit, in der die Rezensionszeit relativ zur aktuellen Zeit in einer für die Sprache und das Land geeigneten Form angegeben wird.

text

LocalizedText

Der lokalisierte Text der Rezension.

original_text

LocalizedText

Der Rezensionstext in der Originalsprache.

rating

double

Eine Zahl zwischen 1,0 und 5,0, auch als Anzahl der Sterne bezeichnet.

author_attribution

AuthorAttribution

Der Autor dieser Rezension.

publish_time

Timestamp

Zeitstempel für die Rezension.

flag_content_uri

string

Ein Link, über den Nutzer ein Problem mit der Rezension melden können.

google_maps_uri

string

Ein Link, über den die Rezension in Google Maps aufgerufen werden kann.

visit_date

Date

Das Datum, an dem der Autor den Ort besucht hat. Die Daten werden auf den Monat gekürzt.

RouteModifiers

Kapselt eine Reihe optionaler Bedingungen, die beim Berechnen der Routen erfüllt sein müssen.

Felder
avoid_tolls

bool

Optional. Wenn dieser Wert auf „true“ gesetzt ist, werden Mautstraßen nach Möglichkeit vermieden. Routen ohne Mautstraßen werden bevorzugt. Gilt nur für die DRIVE- und TWO_WHEELER-TravelMode.

avoid_highways

bool

Optional. Wenn dieser Wert auf „true“ gesetzt ist, werden Autobahnen nach Möglichkeit vermieden und Routen ohne Autobahnen bevorzugt. Gilt nur für die DRIVE- und TWO_WHEELER-TravelMode.

avoid_ferries

bool

Optional. Wenn dieser Wert auf „true“ gesetzt ist, werden Fähren nach Möglichkeit vermieden und Routen ohne Fähren bevorzugt. Gilt nur für die DRIVE- und TWO_WHEELER-TravelMode.

avoid_indoor

bool

Optional. Wenn diese Option auf „true“ gesetzt ist, wird nach Möglichkeit die Navigation in Innenräumen vermieden und Routen ohne Navigation in Innenräumen werden bevorzugt. Gilt nur für das WALK TravelMode.

RoutingParameters

Parameter zum Konfigurieren der Routenberechnungen für die Orte in der Antwort, sowohl entlang einer Route (wo das Ergebnisranking beeinflusst wird) als auch zum Berechnen von Reisezeiten für Ergebnisse.

Felder
origin

LatLng

Optional. Ein expliziter Routing-Ursprung, der den in der Polylinie definierten Ursprung überschreibt. Standardmäßig wird der Ursprung der Polylinie verwendet.

travel_mode

TravelMode

Optional. Die Mobilitätsform.

route_modifiers

RouteModifiers

Optional. Die Routenmodifikatoren.

routing_preference

RoutingPreference

Optional. Gibt an, wie die Routingzusammenfassungen berechnet werden. Der Server versucht, die Route anhand der ausgewählten Routing-Einstellung zu berechnen. Die Einstellung für die Routenplanung unter Berücksichtigung der aktuellen Verkehrslage ist nur für die DRIVE- oder TWO_WHEELER-travelMode verfügbar.

RoutingPreference

Eine Reihe von Werten, die Faktoren angeben, die bei der Berechnung der Route berücksichtigt werden sollen.

Enums
ROUTING_PREFERENCE_UNSPECIFIED Es wurde keine Routingeinstellung angegeben. Standardeinstellung ist TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Berechnet Routen, ohne die aktuelle Verkehrslage zu berücksichtigen. Geeignet, wenn die Verkehrsbedingungen keine Rolle spielen oder nicht anwendbar sind. Mit diesem Wert wird die niedrigste Latenz erzielt. Hinweis: Für TravelMode DRIVE und TWO_WHEELER beruhen die Auswahl der Route und die Reisezeit auf dem Straßennetz sowie der durchschnittlichen zeitunabhängigen Verkehrslage und nicht auf der aktuellen Verkehrslage. Daher können Routen Straßen umfassen, die vorübergehend gesperrt sind. Die Ergebnisse für eine bestimmte Anfrage können sich im Laufe der Zeit aufgrund von Änderungen im Straßennetz, Aktualisierungen der durchschnittlichen Verkehrslage und der Dezentralisierung des Diensts ändern. Außerdem können die Ergebnisse zwischen praktisch gleichwertigen Routen jederzeit und beliebig oft variieren.
TRAFFIC_AWARE Berechnet Routen unter Berücksichtigung der aktuellen Verkehrslage. Im Gegensatz zu TRAFFIC_AWARE_OPTIMAL werden einige Optimierungen angewendet, um die Latenz deutlich zu reduzieren.
TRAFFIC_AWARE_OPTIMAL Berechnet die Routen unter Berücksichtigung der aktuellen Verkehrslage, ohne die meisten Leistungsoptimierungen anzuwenden. Dieser Wert führt zur höchsten Latenz.

RoutingSummary

Die Dauer und Entfernung vom Routing-Ursprung zu einem Ort in der Antwort sowie eine zweite Etappe von diesem Ort zum Ziel, falls angefordert. Hinweis:Wenn Sie routingSummaries in die Feldmaske einfügen, ohne auch den Parameter routingParameters.origin oder searchAlongRouteParameters.polyline.encodedPolyline in die Anfrage aufzunehmen, tritt ein Fehler auf.

Felder
legs[]

Leg

Die einzelnen Etappen der Reise.

Wenn Sie die Reisezeit und Entfernung von einem festgelegten Startort aus berechnen, enthält legs einen einzelnen Abschnitt mit der Dauer und Entfernung vom Start- zum Zielort. Wenn Sie eine Suche entlang der Route durchführen, enthält legs zwei Abschnitte: einen vom Startort zum Ort und einen vom Ort zum Zielort.

directions_uri

string

Ein Link, mit dem die Wegbeschreibung in Google Maps anhand der Wegpunkte aus der angegebenen Routenzusammenfassung angezeigt wird. Die mit diesem Link generierte Route ist nicht unbedingt dieselbe wie die Route, die zum Generieren der Routingzusammenfassung verwendet wurde. Der Link verwendet Informationen aus der Anfrage, einschließlich der Felder routingParameters und searchAlongRouteParameters, um den Link zur Wegbeschreibung zu generieren.

Bein

Ein Abschnitt ist ein einzelner Teil einer Reise von einem Ort zu einem anderen.

Felder
duration

Duration

Die Zeit, die für diesen Abschnitt der Reise benötigt wird.

distance_meters

int32

Die Entfernung dieses Abschnitts der Fahrt.

SearchNearbyRequest

Anfrage-Proto für „In der Nähe suchen“.

Felder
language_code

string

Ortsdetails werden in der bevorzugten Sprache angezeigt, sofern verfügbar. Wenn der Sprachcode nicht angegeben oder nicht erkannt wird, können Details zu einer beliebigen Sprache zurückgegeben werden. Wenn solche Details vorhanden sind, wird Englisch bevorzugt.

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

region_code

string

Der Länder-/Regionscode (CLDR) des Standorts, von dem die Anfrage stammt, im Unicode-Format. Mit diesem Parameter werden die Ortsdetails angezeigt, z. B. der regionsspezifische Ortsname, sofern verfügbar. Der Parameter kann sich je nach anwendbarem Recht auf die Ergebnisse auswirken.

Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Hinweis: Dreistellige Ländercodes werden derzeit nicht unterstützt.

included_types[]

string

Der eingeschlossene Ortstyp (z. B. „restaurant“ oder „gas_station“) aus https://developers.google.com/maps/documentation/places/web-service/place-types.

Es können bis zu 50 Typen aus Tabelle A angegeben werden.

Wenn es widersprüchliche Typen gibt, d.h. ein Typ sowohl in „included_types“ als auch in „excluded_types“ vorkommt, wird der Fehler „INVALID_ARGUMENT“ zurückgegeben.

Wenn ein Ortstyp mit mehreren Typeinschränkungen angegeben wird, werden nur Orte zurückgegeben, die alle Einschränkungen erfüllen. Wenn wir beispielsweise {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} haben, bieten die zurückgegebenen Orte „Restaurant“-bezogene Dienstleistungen an, sind aber nicht in erster Linie „Restaurants“.

excluded_types[]

string

Ausgeschlossener Ortstyp (z. B. „restaurant“ oder „gas_station“) aus https://developers.google.com/maps/documentation/places/web-service/place-types.

Es können bis zu 50 Typen aus Tabelle A angegeben werden.

Wenn der Client sowohl „included_types“ (z.B. „restaurant“) als auch „excluded_types“ (z.B. „cafe“) angibt, sollte die Antwort Orte enthalten, die Restaurants, aber keine Cafés sind. Die Antwort enthält Orte, die mindestens einem der „included_types“ und keinem der „excluded_types“ entsprechen.

Wenn es widersprüchliche Typen gibt, d.h. ein Typ sowohl in „included_types“ als auch in „excluded_types“ vorkommt, wird der Fehler „INVALID_ARGUMENT“ zurückgegeben.

Wenn ein Ortstyp mit mehreren Typeinschränkungen angegeben wird, werden nur Orte zurückgegeben, die alle Einschränkungen erfüllen. Wenn wir beispielsweise {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} haben, bieten die zurückgegebenen Orte „Restaurant“-bezogene Dienstleistungen an, sind aber nicht in erster Linie „Restaurants“.

included_primary_types[]

string

Der primäre Ortstyp (z.B. „restaurant“ oder „gas_station“) aus https://developers.google.com/maps/documentation/places/web-service/place-types. Ein Ort kann nur einen primären Typ aus der Tabelle der unterstützten Typen haben.

Es können bis zu 50 Typen aus Tabelle A angegeben werden.

Wenn es primäre Typen gibt, die sich widersprechen, d.h. ein Typ sowohl in „included_primary_types“ als auch in „excluded_primary_types“ vorkommt, wird der Fehler „INVALID_ARGUMENT“ zurückgegeben.

Wenn ein Ortstyp mit mehreren Typeinschränkungen angegeben wird, werden nur Orte zurückgegeben, die alle Einschränkungen erfüllen. Wenn wir beispielsweise {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} haben, bieten die zurückgegebenen Orte „Restaurant“-bezogene Dienstleistungen an, sind aber nicht in erster Linie „Restaurants“.

excluded_primary_types[]

string

Ausgeschlossener primärer Ortstyp (z.B. „restaurant“ oder „gas_station“) aus https://developers.google.com/maps/documentation/places/web-service/place-types.

Es können bis zu 50 Typen aus Tabelle A angegeben werden.

Wenn es primäre Typen gibt, die sich widersprechen, d.h. ein Typ sowohl in „included_primary_types“ als auch in „excluded_primary_types“ vorkommt, wird der Fehler „INVALID_ARGUMENT“ zurückgegeben.

Wenn ein Ortstyp mit mehreren Typeinschränkungen angegeben wird, werden nur Orte zurückgegeben, die alle Einschränkungen erfüllen. Wenn wir beispielsweise {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} haben, bieten die zurückgegebenen Orte „Restaurant“-bezogene Dienstleistungen an, sind aber nicht in erster Linie „Restaurants“.

max_result_count

int32

Maximale Anzahl der zurückzugebenden Ergebnisse. Der Wert muss zwischen 1 und 20 (Standard) liegen. Wenn die Nummer nicht festgelegt ist, wird auf das obere Limit zurückgegriffen. Wenn die Zahl negativ ist oder das obere Limit überschreitet, wird der Fehler INVALID_ARGUMENT zurückgegeben.

location_restriction

LocationRestriction

Erforderlich. Die Region, in der gesucht werden soll.

rank_preference

RankPreference

So werden die Ergebnisse in der Antwort sortiert.

routing_parameters

RoutingParameters

Optional. Parameter, die sich auf das Routing zu den Suchergebnissen auswirken.

LocationRestriction

Die Region, in der gesucht werden soll.

Felder

Union-Feld type.

Für type ist nur einer der folgenden Werte zulässig:

circle

Circle

Ein Kreis, der durch Mittelpunkt und Radius definiert wird.

RankPreference

So werden die Ergebnisse in der Antwort sortiert.

Enums
RANK_PREFERENCE_UNSPECIFIED Der Wert für „RankPreference“ ist nicht festgelegt. Standardmäßig wird der Rang nach BELIEBTHEIT verwendet.
DISTANCE Sortiert die Ergebnisse nach Entfernung.
POPULARITY Die Ergebnisse werden nach Beliebtheit sortiert.

SearchNearbyResponse

Antwort-Proto für „In der Nähe suchen“.

Felder
places[]

Place

Eine Liste von Orten, die den Anforderungen des Nutzers entsprechen, z. B. Ortstypen, Anzahl der Orte und Einschränkung auf einen bestimmten Ort.

routing_summaries[]

RoutingSummary

Eine Liste mit Routenzusammenfassungen, wobei jeder Eintrag dem entsprechenden Ort mit demselben Index im Feld places zugeordnet ist. Wenn die Zusammenfassung der Routen für einen der Orte nicht verfügbar ist, enthält sie einen leeren Eintrag. Diese Liste sollte so viele Einträge wie die Liste der Orte enthalten, falls diese angefordert wird.

SearchTextRequest

Anfrage-Proto für SearchText.

Felder
text_query

string

Erforderlich. Die Textanfrage für die textbasierte Suche.

language_code

string

Ortsdetails werden in der bevorzugten Sprache angezeigt, sofern verfügbar. Wenn der Sprachcode nicht angegeben oder nicht erkannt wird, können Details zu einer beliebigen Sprache zurückgegeben werden. Wenn solche Details vorhanden sind, wird Englisch bevorzugt.

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

region_code

string

Der Länder-/Regionscode (CLDR) des Standorts, von dem die Anfrage stammt, im Unicode-Format. Mit diesem Parameter werden die Ortsdetails angezeigt, z. B. der regionsspezifische Ortsname, sofern verfügbar. Der Parameter kann sich je nach anwendbarem Recht auf die Ergebnisse auswirken.

Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Hinweis: Dreistellige Ländercodes werden derzeit nicht unterstützt.

rank_preference

RankPreference

So werden die Ergebnisse in der Antwort sortiert.

included_type

string

Der angeforderte Ortstyp. Eine vollständige Liste der unterstützten Typen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/place-types. Es wird nur ein eingeschlossener Typ unterstützt.

open_now

bool

Wird verwendet, um die Suche auf Orte zu beschränken, die derzeit geöffnet sind. Der Standardwert ist "false".

min_rating

double

Ergebnisse herausfiltern, deren durchschnittliche Nutzerbewertung streng unter diesem Grenzwert liegt. Ein gültiger Wert muss ein Gleitkommawert zwischen 0 und 5 (einschließlich) mit einer Schrittweite von 0,5 sein, d. h. [0, 0,5, 1,0, ..., 5,0] einschließlich. Die eingegebene Bewertung wird auf die nächste 0,5 aufgerundet. Bei einer Bewertung von 0,6 werden beispielsweise alle Ergebnisse mit einer Bewertung von unter 1,0 ausgeschlossen.

max_result_count
(deprecated)

int32

Verworfen: Verwenden Sie stattdessen page_size.

Die maximale Anzahl von Ergebnissen pro Seite, die zurückgegeben werden können. Wenn die Anzahl der verfügbaren Ergebnisse größer als max_result_count ist, wird ein next_page_token zurückgegeben, das an page_token übergeben werden kann, um die nächste Seite mit Ergebnissen in nachfolgenden Anfragen abzurufen. Wenn 0 oder kein Wert angegeben ist, wird der Standardwert 20 verwendet. Der Höchstwert beträgt 20. Werte über 20 werden implizit auf 20 umgewandelt. Bei negativen Werten wird der Fehler INVALID_ARGUMENT zurückgegeben.

Wenn sowohl max_result_count als auch page_size angegeben sind, wird max_result_count ignoriert.

page_size

int32

Optional. Die maximale Anzahl von Ergebnissen pro Seite, die zurückgegeben werden können. Wenn die Anzahl der verfügbaren Ergebnisse größer als page_size ist, wird ein next_page_token zurückgegeben, das an page_token übergeben werden kann, um die nächste Seite mit Ergebnissen in nachfolgenden Anfragen abzurufen. Wenn 0 oder kein Wert angegeben ist, wird der Standardwert 20 verwendet. Der Höchstwert ist 20. Werte über 20 werden auf 20 festgelegt. Bei negativen Werten wird der Fehler INVALID_ARGUMENT zurückgegeben.

Wenn sowohl max_result_count als auch page_size angegeben sind, wird max_result_count ignoriert.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen TextSearch-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle Parameter, die für TextSearch bereitgestellt werden, mit Ausnahme von page_token, page_size und max_result_count mit dem ursprünglichen Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.

price_levels[]

PriceLevel

Wird verwendet, um die Suche auf Orte mit bestimmten Preisniveaus zu beschränken. Nutzer können beliebige Kombinationen von Preisniveaus auswählen. Standardmäßig sind alle Preisniveaus ausgewählt.

strict_type_filtering

bool

Wird verwendet, um eine strenge Typfilterung für „included_type“ festzulegen. Wenn auf „true“ gesetzt, werden nur Ergebnisse desselben Typs zurückgegeben. Die Standardeinstellung ist „false“.

location_bias

LocationBias

Die Region, in der gesucht werden soll. Dieser Standort dient als Bias. Das bedeutet, dass Ergebnisse in der Nähe des angegebenen Standorts zurückgegeben werden können. Kann nicht zusammen mit „location_restriction“ festgelegt werden.

location_restriction

LocationRestriction

Die Region, in der gesucht werden soll. Dieser Ort dient als Einschränkung. Das bedeutet, dass Ergebnisse außerhalb des angegebenen Orts nicht zurückgegeben werden. Kann nicht zusammen mit „location_bias“ festgelegt werden.

ev_options

EVOptions

Optional. Legt die durchsuchbaren Optionen für Elektrofahrzeuge für eine Ortsanfrage fest.

routing_parameters

RoutingParameters

Optional. Zusätzliche Parameter für das Weiterleiten zu Ergebnissen.

search_along_route_parameters

SearchAlongRouteParameters

Optional. Zusätzlicher Parameter-Proto für die Suche entlang einer Route.

include_pure_service_area_businesses

bool

Optional. Schließt Unternehmen ohne festen Standort in einem Einzugsgebiet ein, wenn das Feld auf „true“ gesetzt ist. Ein reines Unternehmen ohne festen Standort in einem Einzugsgebiet ist ein Unternehmen, das Kunden vor Ort besucht oder einen Lieferservice hat, aber an seiner Geschäftsadresse keine Kunden empfängt. Dazu gehören z. B. Reinigungsfirmen oder Klempner. Diese Unternehmen haben keine physische Adresse oder keinen Standort bei Google Maps. Für diese Unternehmen werden von Places keine Felder wie location, plus_code und andere standortbezogene Felder zurückgegeben.

EVOptions

Suchbare Optionen für Elektrofahrzeuge einer „Place Search“-Anfrage.

Felder
minimum_charging_rate_kw

double

Optional. Die erforderliche Mindestladegeschwindigkeit in Kilowatt. Ein Ort mit einer Laderate, die niedriger als die angegebene Rate ist, wird herausgefiltert.

connector_types[]

EVConnectorType

Optional. Die Liste der bevorzugten Ladesteckertypen für Elektrofahrzeuge. Ein Ort, der keinen der aufgeführten Connectortypen unterstützt, wird herausgefiltert.

LocationBias

Die Region, in der gesucht werden soll. Dieser Standort dient als Bias. Das bedeutet, dass Ergebnisse in der Nähe des angegebenen Standorts zurückgegeben werden können.

Felder

Union-Feld type.

Für type ist nur einer der folgenden Werte zulässig:

rectangle

Viewport

Ein Rechteck, das durch die Nordost- und die Südwestecke definiert wird. rectangle.high() muss der nordöstliche Punkt des Rechteck-Viewports sein. rectangle.low() muss der südwestliche Punkt des Rechteck-Viewports sein. rectangle.low().latitude() darf nicht größer als rectangle.high().latitude() sein. Das führt zu einem leeren Breitenbereich. Ein rechteckiger Viewport darf nicht breiter als 180 Grad sein.

circle

Circle

Ein Kreis, der durch Mittelpunkt und Radius definiert wird.

LocationRestriction

Die Region, in der gesucht werden soll. Dieser Ort dient als Einschränkung. Das bedeutet, dass Ergebnisse außerhalb des angegebenen Orts nicht zurückgegeben werden.

Felder

Union-Feld type.

Für type ist nur einer der folgenden Werte zulässig:

rectangle

Viewport

Ein Rechteck, das durch die Nordost- und die Südwestecke definiert wird. rectangle.high() muss der nordöstliche Punkt des Rechteck-Viewports sein. rectangle.low() muss der südwestliche Punkt des Rechteck-Viewports sein. rectangle.low().latitude() darf nicht größer als rectangle.high().latitude() sein. Das führt zu einem leeren Breitenbereich. Ein rechteckiger Viewport darf nicht breiter als 180 Grad sein.

RankPreference

So werden die Ergebnisse in der Antwort sortiert.

Enums
RANK_PREFERENCE_UNSPECIFIED Bei einer kategorischen Anfrage wie „Restaurants in New York City“ ist RELEVANCE die Standardeinstellung. Bei nicht kategorischen Anfragen wie „Mountain View, CA“ empfehlen wir, „rankPreference“ nicht festzulegen.
DISTANCE Sortiert die Ergebnisse nach Entfernung.
RELEVANCE Sortiert die Ergebnisse nach Relevanz. Die Sortierreihenfolge wird durch den normalen Ranking-Stack bestimmt.

SearchAlongRouteParameters

Gibt eine vorab berechnete Polylinie aus der Routes API an, die die zu durchsuchende Route definiert. Die Suche entlang einer Route ähnelt der Verwendung der Anfrageoption locationBias oder locationRestriction, um die Suchergebnisse zu gewichten. Mit den Optionen locationBias und locationRestriction können Sie zwar eine Region angeben, um die Suchergebnisse zu gewichten, mit dieser Option können Sie die Ergebnisse jedoch entlang einer Reiseroute gewichten.

Es kann nicht garantiert werden, dass die Ergebnisse auf der angegebenen Route liegen. Sie werden vielmehr innerhalb des Suchbereichs, der durch die Polylinie und optional durch locationBias oder locationRestriction definiert wird, nach minimalen Umwegzeiten vom Start- zum Zielort sortiert. Die Ergebnisse können sich auf eine alternative Route beziehen, insbesondere wenn die angegebene Polylinie keine optimale Route vom Start- zum Zielort definiert.

Felder
polyline

Polyline

Erforderlich. Die Routen-Polylinie.

SearchTextResponse

Antwort-Proto für SearchText.

Felder
places[]

Place

Eine Liste von Orten, die den Textsuchkriterien des Nutzers entsprechen.

routing_summaries[]

RoutingSummary

Eine Liste mit Routenzusammenfassungen, wobei jeder Eintrag dem entsprechenden Ort mit demselben Index im Feld places zugeordnet ist. Wenn die Zusammenfassung der Routen für einen der Orte nicht verfügbar ist, enthält sie einen leeren Eintrag. Diese Liste enthält so viele Einträge wie die Liste der Orte, falls angefordert.

contextual_contents[]

ContextualContent

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Eine Liste mit Kontextinhalten, wobei jeder Eintrag dem entsprechenden Ort im selben Index im Feld „places“ zugeordnet ist. Inhalte, die für text_query in der Anfrage relevant sind, werden bevorzugt. Wenn die kontextbezogenen Inhalte für einen der Orte nicht verfügbar sind, werden nicht kontextbezogene Inhalte zurückgegeben. Das Feld ist nur leer, wenn die Inhalte für diesen Ort nicht verfügbar sind. Diese Liste enthält so viele Einträge wie die Liste der Orte, falls angefordert.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen oder leer ist, sind keine weiteren Seiten vorhanden.

search_uri

string

Über einen Link kann der Nutzer mit derselben Textanfrage wie in der Anfrage in Google Maps suchen.

TravelMode

Optionen für Verkehrsmittel. Diese Optionen entsprechen den Funktionen der Routes API.

Enums
TRAVEL_MODE_UNSPECIFIED Es wurde keine Fortbewegungsart angegeben. Die Standardeinstellung ist DRIVE.
DRIVE Mit dem Pkw anreisen
BICYCLE Mit dem Fahrrad reisen. Nicht unterstützt mit search_along_route_parameters.
WALK Zu Fuß unterwegs sein Nicht unterstützt mit search_along_route_parameters.
TWO_WHEELER Motorisierte Zweiräder aller Art, z. B. Motorroller und Motorräder. Diese Mobilitätsform unterscheidet sich von BICYCLE, die von Menschen betriebene Transportmittel umfasst. Nicht unterstützt mit search_along_route_parameters. Nur in den Ländern verfügbar, die unter Länder und Regionen, die bei Zweirädern möglich sind aufgeführt sind.