Package google.maps.places.v1

Index

• Places (Benutzeroberfläche)
• AddressDescriptor (Meldung)
• AddressDescriptor.Area (Meldung)
• AddressDescriptor.Area.Containment (Aufzählung)
• AddressDescriptor.Landmark (Meldung)
• AddressDescriptor.Landmark.SpatialRelationship (Aufzählung)
• AuthorAttribution (Meldung)
• AutocompletePlacesRequest (Meldung)
• AutocompletePlacesRequest.LocationBias (Meldung)
• AutocompletePlacesRequest.LocationRestriction (Meldung)
• AutocompletePlacesResponse (Meldung)
• AutocompletePlacesResponse.Suggestion (Meldung)
• AutocompletePlacesResponse.Suggestion.FormattableText (Meldung)
• AutocompletePlacesResponse.Suggestion.PlacePrediction (Meldung)
• AutocompletePlacesResponse.Suggestion.QueryPrediction (Meldung)
• AutocompletePlacesResponse.Suggestion.StringRange (Meldung)
• AutocompletePlacesResponse.Suggestion.StructuredFormat (Meldung)
• Circle (Meldung)
• ContentBlock (Meldung)
• ContextualContent (Meldung)
• ContextualContent.Justification (Meldung)
• ContextualContent.Justification.BusinessAvailabilityAttributesJustification (Meldung)
• ContextualContent.Justification.ReviewJustification (Meldung)
• ContextualContent.Justification.ReviewJustification.HighlightedText (Meldung)
• ContextualContent.Justification.ReviewJustification.HighlightedText.HighlightedTextRange (Meldung)
• EVChargeOptions (Meldung)
• EVChargeOptions.ConnectorAggregation (Meldung)
• EVConnectorType (Aufzählung)
• FuelOptions (Meldung)
• FuelOptions.FuelPrice (Meldung)
• FuelOptions.FuelPrice.FuelType (Aufzählung)
• GetPhotoMediaRequest (Meldung)
• GetPlaceRequest (Meldung)
• Photo (Meldung)
• PhotoMedia (Meldung)
• Place (Meldung)
• Place.AccessibilityOptions (Meldung)
• Place.AddressComponent (Meldung)
• Place.AreaSummary (Meldung)
• Place.Attribution (Meldung)
• Place.BusinessStatus (Aufzählung)
• Place.ContainingPlace (Meldung)
• Place.GenerativeSummary (Meldung)
• Place.GoogleMapsLinks (Meldung)
• Place.OpeningHours (Meldung)
• Place.OpeningHours.Period (Meldung)
• Place.OpeningHours.Period.Point (Meldung)
• Place.OpeningHours.SecondaryHoursType (Aufzählung)
• Place.OpeningHours.SpecialDay (Meldung)
• Place.ParkingOptions (Meldung)
• Place.PaymentOptions (Meldung)
• Place.PlusCode (Meldung)
• Place.SubDestination (Meldung)
• Polyline (Meldung)
• PriceLevel (Aufzählung)
• PriceRange (Meldung)
• References (Meldung)
• Review (Meldung)
• RouteModifiers (Meldung)
• RoutingParameters (Meldung)
• RoutingPreference (Aufzählung)
• RoutingSummary (Meldung)
• RoutingSummary.Leg (Meldung)
• SearchNearbyRequest (Meldung)
• SearchNearbyRequest.LocationRestriction (Meldung)
• SearchNearbyRequest.RankPreference (Aufzählung)
• SearchNearbyResponse (Meldung)
• SearchTextRequest (Meldung)
• SearchTextRequest.EVOptions (Meldung)
• SearchTextRequest.LocationBias (Meldung)
• SearchTextRequest.LocationRestriction (Meldung)
• SearchTextRequest.RankPreference (Aufzählung)
• SearchTextRequest.SearchAlongRouteParameters (Meldung)
• SearchTextResponse (Meldung)
• TravelMode (Aufzählung)

Orte

Dienstdefinition für die Places API. Hinweis: Für jede Anfrage (außer für Autocomplete-Anfragen) ist eine Feldmaske erforderlich, die außerhalb des Anfrage-Prototyps festgelegt ist (all/* wird nicht vorausgesetzt). 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) Ruft ein Fotomedium mit einem Fotoreferenzstring ab. Autorisierungsbereiche Erfordert den folgenden OAuth-Bereich: https://www.googleapis.com/auth/cloud-platform

GetPlace
rpc GetPlace(GetPlaceRequest) returns (Place) Sie können die Details eines Orts anhand seines Ressourcennamens abrufen. Dieser 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) Nach Orten 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 über Textabfrage Autorisierungsbereiche Erfordert den folgenden OAuth-Bereich: https://www.googleapis.com/auth/cloud-platform

AddressDescriptor

Eine relationale Beschreibung eines Standorts. Enthält eine sortierte Liste von Sehenswürdigkeiten in der Nähe und genaue umgebende Gebiete sowie deren Beziehung zum Zielort.

Felder
landmarks[]	Landmark Eine nach Rang sortierte Liste von Sehenswürdigkeiten in der Nähe. Die bekanntesten und nächstgelegenen Sehenswürdigkeiten werden zuerst angezeigt.
areas[]	Area Eine sortierte Liste von enthaltenen oder benachbarten Gebieten. Die am besten erkennbaren und präzisesten Bereiche werden zuerst eingestuft.

Gebiet

Informationen zum Gebiet und zum Verhältnis des Gebiets zum Zielstandort.

Zu den Gebieten gehören genaue Ortsteile, Viertel und große Anlagen, die zur Beschreibung eines Standorts nützlich sind.

Felder
name	string Der Ressourcenname des Gebiets.
place_id	string Die Orts-ID des Gebiets.
display_name	LocalizedText Der Anzeigename des Gebiets.
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 Gebietsregion, nahe dem Zentrum.
OUTSKIRTS	Der Zielstandort befindet sich innerhalb des Gebiets, nahe am Rand.
NEAR	Der Zielort liegt außerhalb des Gebiets, aber in der Nähe.

Sehenswürdigkeit

Grundlegende Informationen zum Wahrzeichen und die Beziehung des Wahrzeichens zum Zielort.

Markante Orte sind gut sichtbare Orte, die zur Beschreibung eines Standorts verwendet werden können.

Felder
name	string Der Ressourcenname des Wahrzeichens.
place_id	string Die Orts-ID des Wahrzeichens.
display_name	LocalizedText Der Anzeigename des Wahrzeichens.
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 Markierungspunkt.
straight_line_distance_meters	float Die gerade Entfernung in Metern zwischen dem Mittelpunkt des Ziels und dem Mittelpunkt der Sehenswürdigkeit. In einigen Fällen kann dieser Wert länger als travel_distance_meters sein.
travel_distance_meters	float Die zurückgelegte Strecke in Metern entlang des Straßennetzes vom Ziel zur Sehenswürdigkeit, sofern bekannt. Bei diesem Wert wird die Art der Fortbewegung (z. B. zu Fuß, mit dem Auto oder mit dem Fahrrad) nicht berücksichtigt.

SpatialRelationship

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

Enums
NEAR	Dies ist die Standardbeziehung, wenn keine der folgenden genaueren Angaben zutrifft.
WITHIN	Das Wahrzeichen hat eine räumliche Geometrie und das Ziel befindet sich innerhalb seiner Grenzen.
BESIDE	Das Ziel befindet sich direkt neben dem Wahrzeichen.
ACROSS_THE_ROAD	Das Ziel befindet sich direkt gegenüber dem markanten Punkt auf der anderen Straßenseite.
DOWN_THE_ROAD	Sie muss sich auf derselben Route wie das Wahrzeichen befinden, aber nicht daneben oder gegenüber.
AROUND_THE_CORNER	Nicht auf derselben Route wie das Wahrzeichen, aber nur eine Kurve entfernt.
BEHIND	In der Nähe des Gebäudes des Wahrzeichens, aber weiter entfernt von den Straßeneinfahrten.

AuthorAttribution

Informationen zum Autor der von Nutzern erstellten Inhalte. Verwendet in Photo und Review.

Felder
display_name	string Name des Autors der Photo oder Review.
uri	string URI des Autors der Photo oder Review.
photo_uri	string URI des Profilbilds des Autors der Photo oder Review.

AutocompletePlacesRequest

Proto für AutocompletePlaces anfordern

Felder
input	string Erforderlich. Der Textstring, in dem 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 keines der beiden festgelegt ist, werden die Ergebnisse durch die IP-Adresse verzerrt. Das bedeutet, dass die IP-Adresse einem ungenauen Standort zugeordnet und als Verzerrungssignal verwendet wird.
location_restriction	LocationRestriction Optional. Ergebnisse auf einen bestimmten Standort beschränken. Es sollte höchstens eines von location_bias oder location_restriction festgelegt sein. Wenn keines der beiden festgelegt ist, werden die Ergebnisse durch die IP-Adresse verzerrt. Das bedeutet, dass die IP-Adresse einem ungenauen Standort zugeordnet und als Verzerrungssignal verwendet wird.
included_primary_types[]	string Optional. Enthält den primären Ortstyp (z. B. „restaurant“ oder „gas_station“) in „Place Types“ (https://developers.google.com/maps/documentation/places/web-service/place-types) 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. Es werden nur Ergebnisse in den angegebenen Regionen berücksichtigt. Diese werden als bis zu 15 zweistellige CLDR-Regionscodes angegeben. Eine leere Gruppe 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 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 für den zurückgegebenen Ort keine Übersetzung aus der Landessprache in language_code vorhanden ist.
region_code	string Optional. Der Regionscode, angegeben als zweistelliger CLDR-Regionscode. Das wirkt sich auf die Adressformatierung, das Ergebnisranking und möglicherweise auch darauf aus, 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 einzugrenzen.
origin	LatLng Optional. Der Startpunkt, von dem aus die geodätische Entfernung zum Ziel berechnet werden soll (wird als distance_meters zurückgegeben). Wenn dieser Wert weggelassen wird, wird die geodätische Entfernung nicht zurückgegeben.
input_offset	int32 Optional. Ein nullbasierter Unicode-Zeichenabstand von input, der die Cursorposition in input angibt. Die Cursorposition kann sich darauf auswirken, welche Vorschläge zurückgegeben werden. Wenn leer, ist der Standardwert input.
include_query_predictions	bool Optional. Wenn „true“ festgelegt ist, enthält die Antwort sowohl Orts- als auch Suchanfragevorschläge. Andernfalls werden in der Antwort nur Ortsvorschläge zurückgegeben.
session_token	string Optional. Ein String, der eine Autocomplete-Sitzung zu Abrechnungszwecken identifiziert. Muss ein URL- und Dateinamen-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 beginnt, und endet, wenn er einen Ort auswählt und ein Aufruf zu „Place Details“ oder „Address Validation“ erfolgt. Jede Sitzung kann mehrere Abfragen und eine Anfrage vom Typ „Place Details“ oder „Address Validation“ umfassen. Die Anmeldedaten, die für jede Anfrage innerhalb einer Sitzung verwendet werden, müssen zu demselben 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. Für jede Sitzung muss ein neues Token generiert werden. Wir empfehlen die Verwendung einer UUID der Version 4. Die Anmeldedaten, die für alle Anfragen für die automatische Vervollständigung von Orten, „Places Details“ und die Adressbestätigung innerhalb einer Sitzung verwendet werden, müssen zu demselben 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. Fügen Sie Unternehmen ohne festen Standort in einem Einzugsgebiet hinzu, wenn das Feld auf „true“ gesetzt ist. Ein 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 Adresse oder keinen Standort auf Google Maps. Für diese Unternehmen werden keine Felder wie location, plus_code und andere standortbezogene Felder zurückgegeben.

LocationBias

Die Region, in der gesucht werden soll. Die Ergebnisse können in der angegebenen Region verzerrt sein.

Felder
Union-Feld type. Für type ist nur einer der folgenden Werte zulässig:
rectangle	Viewport Ein Ansichtsbereich, der durch eine Nordost- und eine Südwestecke definiert ist.
circle	Circle Ein Kreis, der durch einen Mittelpunkt und einen Radius definiert ist.

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 Ansichtsbereich, der durch eine Nordost- und eine Südwestecke definiert ist.
circle	Circle Ein Kreis, der durch einen Mittelpunkt und einen Radius definiert ist.

AutocompletePlacesResponse

Antwort-Prototyp für AutocompletePlaces.

Felder
suggestions[]	Suggestion Enthält eine Liste mit Vorschlägen, sortiert in absteigender Reihenfolge nach Relevanz.

Vorschlag

Ein 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 Suchanfrage.

FormattableText

Text, der eine Orts- oder Suchanfrage darstellt. Der Text kann unverändert oder formatiert verwendet 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 bestimmte Teile von text formatiert werden. Die Teilstrings stimmen möglicherweise nicht genau mit input überein, wenn die Übereinstimmung anhand anderer Kriterien als der Stringübereinstimmung ermittelt wurde (z. B. Rechtschreibkorrekturen oder Transliterationen). Diese Werte sind Unicode-Zeichenabstände von text. Die Bereiche sind garantiert in aufsteigender Reihenfolge der Offsetwerte angeordnet.

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 Der für Menschen lesbare Name des zurückgegebenen Ergebnisses. Bei Ergebnissen für Unternehmen sind dies in der Regel der Name und die Adresse des Unternehmens. text wird Entwicklern empfohlen, die ein einzelnes UI-Element anzeigen möchten. Entwickler, die zwei separate, aber zusammenhängende UI-Elemente anzeigen möchten, sollten stattdessen structured_format verwenden. Es gibt zwei Möglichkeiten, eine Ortsvorhersage darzustellen. Nutzer sollten nicht versuchen, structured_format in text oder umgekehrt zu parsen. Dieser Text kann sich von der display_name unterscheiden, die von „GetPlace“ zurückgegeben wird. Kann in verschiedenen Sprachen verfasst sein, wenn die Anfragen input und language_code in verschiedenen Sprachen sind oder wenn für den Ort keine Übersetzung aus der Landessprache in language_code verfügbar ist.
structured_format	StructuredFormat Eine Aufschlüsselung der Ortsvorhersage in Haupttext mit dem Namen des Orts und sekundären Text mit zusätzlichen eindeutigen Merkmalen (z. B. einer Stadt oder Region). structured_format wird Entwicklern empfohlen, die zwei separate, aber zusammenhängende UI-Elemente anzeigen möchten. Entwickler, die ein einzelnes UI-Element anzeigen möchten, sollten stattdessen text verwenden. Es gibt zwei Möglichkeiten, eine Ortsvorhersage darzustellen. Nutzer sollten nicht versuchen, structured_format in text oder umgekehrt zu parsen.
types[]	string Liste der Typen, die für diesen Ort gelten, aus Tabelle A oder Tabelle B in https://developers.google.com/maps/documentation/places/web-service/place-types. Ein Typ ist eine Kategorisierung eines Orts. Orte mit demselben Typ haben ähnliche Merkmale.
distance_meters	int32 Die Länge der Geodäten in Metern von 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 von Suchanfragen.

Felder
text	FormattableText Der vorhergesagte Text. Dieser Text stellt keinen Ort dar, sondern eine Textabfrage, die in einem Suchendpunkt verwendet werden kann, z. B. in der Textsuche. text wird Entwicklern empfohlen, die ein einzelnes UI-Element anzeigen möchten. Entwickler, die zwei separate, aber zusammenhängende UI-Elemente anzeigen möchten, sollten stattdessen structured_format verwenden. Es gibt zwei verschiedene Möglichkeiten, eine Suchanfragevorhersage darzustellen. Nutzer sollten nicht versuchen, structured_format in text oder umgekehrt zu parsen. Kann in verschiedenen Sprachen sein, wenn die Anfrage input und language_code in verschiedenen Sprachen sind oder wenn für einen Teil der Anfrage keine Übersetzung aus der Landessprache 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 eindeutigen Merkmalen (z. B. einer Stadt oder Region). structured_format wird Entwicklern empfohlen, die zwei separate, aber zusammenhängende UI-Elemente anzeigen möchten. Entwickler, die ein einzelnes UI-Element anzeigen möchten, sollten stattdessen text verwenden. Es gibt zwei verschiedene Möglichkeiten, eine Suchanfragevorhersage darzustellen. Nutzer sollten nicht versuchen, structured_format in text oder umgekehrt zu parsen.

StringRange

Ermittelt einen Teilstring in einem bestimmten Text.

Felder
start_offset	int32 Der nullbasierte Offset des ersten Unicode-Zeichens des Strings (einschließlich).
end_offset	int32 Der Offset des letzten Unicode-Zeichens (ab Null) (exklusiv).

StructuredFormat

Enthält eine Aufschlüsselung einer Orts- oder Suchanfragevorhersage in Haupttext und sekundären Text.

Bei Ortsvorschlägen enthält der Haupttext den spezifischen Namen des Orts. Bei Suchanfragevorschlägen enthält der Haupttext die Suchanfrage.

Der sekundäre Text enthält zusätzliche Merkmale zur Klärung von Mehrdeutigkeiten (z. B. eine Stadt oder Region), um den Ort weiter zu identifizieren oder die Suchanfrage zu verfeinern.

Felder
main_text	FormattableText Der Name des Orts oder der Suchanfrage.
secondary_text	FormattableText Stellt zusätzliche Merkmale zur eindeutigen Identifizierung des Orts dar (z. B. eine Stadt oder Region), um den Ort weiter zu identifizieren oder die Suchanfrage zu verfeinern.

Kreis

Kreis mit einem LatLng als Mittelpunkt und Radius.

Felder
center	LatLng Erforderlich. Breiten- und Längengrad für die Mitte festlegen Der Breitengrad muss im Bereich [-90,0, 90,0] liegen. Der Längengrad muss im Bereich [-180,0, +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
topic	string Das Thema des Inhalts, z. B. „Übersicht“ oder „Restaurant“.
content	LocalizedText Zum Thema passende Inhalte
references	References Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Verweise, die sich auf diesen Inhaltsblock beziehen.

ContextualContent

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

Inhalte, die zum Kontext der Ortsabfrage passen.

Felder
reviews[]	Review Liste der Rezensionen zu diesem Ort, die im Kontext der Ortsabfrage stehen.
photos[]	Photo Informationen (einschließlich Verweise) zu Fotos dieses Orts im Kontext der Ortsabfrage.
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 sehen Sie einige Attribute eines Unternehmens, die für einen Endnutzer interessant sein könnten.

Felder
takeout	bool Ob ein Ort Gerichte zum Mitnehmen anbietet.
delivery	bool Ob ein Unternehmen einen Lieferservice anbietet.
dine_in	bool Ob ein Lokal Speisen und Getränke zum Verzehr vor Ort anbietet.

ReviewJustification

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

Begründungen für Nutzerrezensionen Hier wird ein Abschnitt der Rezension hervorgehoben, der für einen Endnutzer interessant ist. Wenn die Suchanfrage beispielsweise „Holzofenpizza“ lautet, wird in der Begründung der Rezension der für die Suchanfrage relevante Text hervorgehoben.

Felder
highlighted_text	HighlightedText
review	Review Die Rezension, aus der der markierte Text generiert wurde.

HighlightedText

Der durch die Ausrichtung hervorgehobene Text. Dies ist ein Teil der Rezension selbst. Das genaue Wort, das hervorgehoben werden soll, wird durch den HighlightedTextRange gekennzeichnet. Es können mehrere Wörter im Text hervorgehoben werden.

Felder
text	string
highlighted_text_ranges[]	HighlightedTextRange Die Liste der Bereiche des hervorgehobenen Texts.

HighlightedTextRange

Der Bereich des markierten Texts.

Felder
start_index	int32
end_index	int32

EVChargeOptions

Informationen zur Ladestation für Elektrofahrzeuge, die in Google Places gehostet wird. Die Terminologie folgt https://afdc.energy.gov/fuels/electricity_infrastructure.html. Ein Anschluss kann jeweils ein Auto laden. Ein Anschluss 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 Ladestationen jedoch mehrere Anschlüsse haben können, aber nur ein Auto gleichzeitig laden können, ist die Anzahl der Anschlüsse möglicherweise höher als die Gesamtzahl der Autos, die gleichzeitig geladen werden können.
connector_aggregation[]	ConnectorAggregation Eine Liste von Aggregationen von Ladesteckern für Elektrofahrzeuge, die Stecker desselben Typs und derselben Ladegeschwindigkeit enthalten.

ConnectorAggregation

Informationen zum Laden von Elektrofahrzeugen, gruppiert nach [type, max_charge_rate_kw]. Zeigt die Zusammenführung von Ladestationen für Elektrofahrzeuge mit demselben Typ und derselben maximalen Ladeleistung in kW an.

Felder
type	EVConnectorType Der Connector-Typ dieser Aggregation.
max_charge_rate_kw	double Die statische maximale Ladegeschwindigkeit in kW jedes Anschlusses in der Aggregation.
count	int32 Anzahl der Anschlüsse 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 derzeit verfügbaren Verbindungen in dieser Aggregation.
out_of_service_count	int32 Anzahl der Anschlüsse in dieser Aggregation, die derzeit außer Betrieb sind.

EVConnectorType

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

Enums
EV_CONNECTOR_TYPE_UNSPECIFIED	Nicht angegebener Anschluss.
EV_CONNECTOR_TYPE_OTHER	Andere Anschlusstypen
EV_CONNECTOR_TYPE_J1772	J1772-Typ-1-Stecker
EV_CONNECTOR_TYPE_TYPE_2	IEC 62196-Stecker vom Typ 2. Wird oft als MENNEKES bezeichnet.
EV_CONNECTOR_TYPE_CHADEMO	CHAdeMO-Anschluss
EV_CONNECTOR_TYPE_CCS_COMBO_1	Kombiniertes Ladesystem (Wechselstrom und Gleichstrom). Basierend auf SAE. Typ-1-J-1772-Stecker
EV_CONNECTOR_TYPE_CCS_COMBO_2	Kombiniertes Ladesystem (Wechselstrom und Gleichstrom). Basierend auf dem Mennekes-Stecker vom Typ 2
EV_CONNECTOR_TYPE_TESLA	Der generische TESLA-Connector. In Nordamerika ist dies ein NACS, in anderen Teilen der Welt kann es sich aber auch um ein Nicht-NACS handeln (z.B. CCS Combo 2 (CCS2) oder GB/T). Dieser Wert ist weniger repräsentativ für einen tatsächlichen Anschlusstyp, sondern gibt an, ob ein Tesla-Fahrzeug an einer Ladestation von Tesla aufgeladen werden kann.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T	Der GB/T-Typ entspricht dem GB/T-Standard in China. Dieser Typ deckt alle GB_T-Typen ab.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET	Nicht angegebene Steckdose.
EV_CONNECTOR_TYPE_NACS	Das nordamerikanische Ladesystem (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 jeden Kraftstofftyp an dieser Tankstelle. Es gibt einen Eintrag pro Kraftstofftyp, den diese Tankstelle anbietet. Die Reihenfolge spielt keine Rolle.

FuelPrice

Informationen zu Kraftstoffpreisen 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

Kraftstofftypen

Enums
FUEL_TYPE_UNSPECIFIED	Nicht angegebener Kraftstofftyp.
DIESEL	Dieselkraftstoff
DIESEL_PLUS	Diesel plus Kraftstoff.
REGULAR_UNLEADED	Normales bleifreies Benzin.
MIDGRADE	Mittelklasse.
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 (LPG).
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 mit dem Namen einer Fotoressource.

Felder
name	string Erforderlich. Der Ressourcenname eines Fotos im Format places/{place_id}/photos/{photo_reference}/media. Der Ressourcenname eines Fotos, der im Feld photos.name eines Ortsobjekts zurückgegeben wird, hat das Format places/{place_id}/photos/{photo_reference}. Fügen Sie am Ende der Fotoressource /media an, um den Namen der Fotomedienressource zu erhalten.
max_width_px	int32 Optional. Gibt die maximal gewünschte Breite des Bilds in Pixeln an. Ist das Bild kleiner als die angegebenen Werte, 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. Sowohl für die Property „max_height_px“ als auch für „max_width_px“ ist eine Ganzzahl zwischen 1 und 4.800 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 Bilds in Pixeln an. Ist das Bild kleiner als die angegebenen Werte, 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. Sowohl für die Property „max_height_px“ als auch für „max_width_px“ ist eine Ganzzahl zwischen 1 und 4.800 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 diese Option nicht festgelegt ist, wird eine HTTP-Weiterleitung erstellt, 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, einem String im Format places/{place_id}.

Felder
name	string Erforderlich. Der Ressourcenname eines Orts im Format places/{place_id}.
language_code	string Optional. Details zum Ort 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. Mit diesem Parameter werden die Details zum Ort angezeigt, z. B. der regionsspezifische Ortsname, sofern verfügbar. Der Parameter kann sich auf die Ergebnisse auswirken, die gemäß anwendbarem Recht angezeigt werden. Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Dreistellige Regionscodes werden derzeit nicht unterstützt.
session_token	string Optional. Ein String, der eine Autocomplete-Sitzung zu Abrechnungszwecken identifiziert. Muss ein URL- und Dateinamen-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 beginnt, und endet, wenn er einen Ort auswählt und ein Aufruf zu „Place Details“ oder „Address Validation“ erfolgt. Jede Sitzung kann mehrere Abfragen und eine Anfrage vom Typ „Place Details“ oder „Address Validation“ umfassen. Die Anmeldedaten, die für jede Anfrage innerhalb einer Sitzung verwendet werden, müssen zu demselben 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. Für jede Sitzung muss ein neues Token generiert werden. Wir empfehlen die Verwendung einer UUID der Version 4. Die Anmeldedaten, die für alle Anfragen für die automatische Vervollständigung von Orten, „Places Details“ und die Adressbestätigung innerhalb einer Sitzung verwendet werden, müssen zu demselben 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 Kennung. Eine Referenz, die dieses Ortsfoto darstellt und mit der es wiedergefunden werden kann (auch als API-Ressourcenname places/{place_id}/photos/{photo} bezeichnet).
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 Einen Link, über den das Foto auf Google Maps angezeigt wird.

PhotoMedia

Ein Fotomedium aus der Places API.

Felder
name	string Der Ressourcenname eines Fotos 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 zu einem Ort.

Felder
name	string Der Ressourcenname dieses Orts im Format places/{place_id}. Kann verwendet werden, um den Ort abzurufen.
id	string Die eindeutige Kennung eines Orts.
display_name	LocalizedText Der lokalisierte Name des Orts, geeignet als kurze menschenlesbare Beschreibung. Beispiel: „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 Ergebnisses. Dieser Typ muss einer der von der Places API unterstützten Typen sein. Beispiele: „Restaurant“, „Café“, „Flughafen“. 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.
primary_type_display_name	LocalizedText Der Anzeigename des primären Typs, gegebenenfalls lokalisiert in die Sprache der Anfrage. 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.
national_phone_number	string Eine für Menschen lesbare Telefonnummer für den Ort im Landesformat.
international_phone_number	string Eine für Menschen lesbare Telefonnummer für den Ort im internationalen Format.
formatted_address	string Eine vollständige, visuell lesbare Adresse für diesen Ort.
short_formatted_address	string Eine kurze, visuell lesbare Adresse für diesen Ort.
address_components[]	AddressComponent Wiederholte Komponenten für jede Ortsebene. 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 im „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 des Orts mit Breiten-/Längengrad
location	LatLng Die Position dieses Orts.
viewport	Viewport Ein Darstellungsbereich, der für die Darstellung des Orts auf einer durchschnittlich großen Karte geeignet ist. Dieser Ansichtsbereich darf nicht als physische Grenze oder als 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 Standorten, die zu einer Kette gehören (z.B. einem IKEA-Geschäft), ist dies in der Regel die Website des einzelnen Geschäfts, nicht die Website 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 durchgehend geöffnet ist (24 Stunden), wird das Feld close nicht festgelegt. Für Kunden ist es wichtig zu wissen, dass „Immer geöffnet“ (24 Stunden) als [open][google.maps.places.v1.Place.OpeningHours.Period.open]-Zeitraum mit [day][Point.day] mit dem Wert 0, [hour][Point.hour] mit dem Wert 0 und [minute][Point.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-Microformat: http://microformats.org/wiki/adr.
business_status	BusinessStatus Der Geschäftsstatus des Orts.
price_level	PriceLevel Preisniveau des Orts.
attributions[]	Attribution Datenanbieter, die mit diesem Ergebnis angezeigt werden müssen.
icon_mask_base_uri	string Eine gekürzte URL zu einer Symbolmaske. Nutzer können auf einen anderen Symboltyp zugreifen, indem sie am Ende ein Typsuffix anhängen (z. B. „.svg“ oder „.png“).
icon_background_color	string Hintergrundfarbe für „icon_mask“ im Hexadezimalformat, 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“ von „all_hours“, das für Tage mit abweichenden Öffnungszeiten festgelegt ist.
current_secondary_opening_hours[]	OpeningHours Enthält eine Reihe von Einträgen für die nächsten sieben Tage, einschließlich Informationen zu den Nebenöffnungszeiten eines Unternehmens. Die Öffnungszeiten unterscheiden sich von den regulären Öffnungszeiten des Unternehmens. Ein Restaurant kann beispielsweise die Öffnungszeiten des Drive-Through-Bereichs oder der Lieferservice als sekundäre Öffnungszeiten angeben. In diesem Feld wird das Unterfeld „type“ ausgefüllt, das auf Grundlage der Typen des Orts aus einer vordefinierten Liste von Öffnungszeitentypen (z. B. DRIVE_THROUGH, PICKUP oder TAKEOUT) zusammengestellt wird. Dieses Feld enthält das Unterfeld „special_days“ von „all_hours“, das für Tage mit abweichenden Öffnungszeiten festgelegt ist.
regular_secondary_opening_hours[]	OpeningHours Enthält eine Reihe von Einträgen mit Informationen zu den regulären Nebenöffnungszeiten eines Unternehmens. Die Öffnungszeiten unterscheiden sich von den regulären Öffnungszeiten des Unternehmens. Ein Restaurant kann beispielsweise die Öffnungszeiten des Drive-Through-Bereichs oder der Lieferservice als sekundäre Öffnungszeiten angeben. In diesem Feld wird das Unterfeld „type“ ausgefüllt, das auf Grundlage der Typen des Orts aus einer vordefinierten Liste von Öffnungszeitentypen (z. B. DRIVE_THROUGH, PICKUP oder TAKEOUT) zusammengestellt wird.
editorial_summary	LocalizedText Enthält eine Zusammenfassung des Orts. Eine Zusammenfassung besteht aus einer textbasierten Übersicht und enthält gegebenenfalls auch den Sprachcode. Der Zusammenfassungstext muss unverändert präsentiert werden und darf nicht geändert werden.
payment_options	PaymentOptions Zahlungsoptionen, die vom Standort 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 am Standort.
sub_destinations[]	SubDestination Eine Liste von untergeordneten Zielen, die sich auf den Ort beziehen.
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 Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. KI-generierte Zusammenfassung des Orts.
area_summary	AreaSummary Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. KI-generierte Zusammenfassung der Region, in der sich der Ort befindet.
containing_places[]	ContainingPlace Liste der Orte, in denen sich der aktuelle Ort befindet.
address_descriptor	AddressDescriptor Der Adressbeschreiber des Orts. Adressdeskriptoren enthalten zusätzliche Informationen, die dazu beitragen, einen Ort anhand von Sehenswürdigkeiten und Gebieten zu beschreiben. Informationen zur regionalen Abdeckung von Adressbeschreibungen finden Sie unter https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
google_maps_links	GoogleMapsLinks Links, mit denen verschiedene Google Maps-Aktionen ausgelöst werden.
price_range	PriceRange Der Preisbereich, der mit einem Ort verknüpft ist.
utc_offset_minutes	int32 Die Anzahl der Minuten, um die die Zeitzone dieses Orts derzeit von UTC abweicht. Dieser Wert 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 Datenexporte unterstützt.
delivery	bool Gibt an, ob das Unternehmen Lieferungen 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 der Ort Reservierungen unterstützt.
serves_breakfast	bool Gibt an, ob in der Unterkunft Frühstück serviert wird.
serves_lunch	bool Gibt an, ob in der Unterkunft Mittagessen serviert wird.
serves_dinner	bool Gibt an, ob im Restaurant 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 im Restaurant Brunch angeboten wird.
serves_vegetarian_food	bool Gibt an, ob im Restaurant vegetarische Gerichte serviert werden.
outdoor_seating	bool Es gibt Sitzgelegenheiten im Freien.
live_music	bool Es gibt Livemusik.
menu_for_children	bool Es gibt eine Kinderkarte.
serves_cocktails	bool Hier werden Cocktails serviert.
serves_dessert	bool Es werden Desserts serviert.
serves_coffee	bool Hier wird Kaffee serviert.
good_for_children	bool Der Ort ist gut für Kinder.
allows_dogs	bool Hunde sind am Veranstaltungsort erlaubt.
restroom	bool Es gibt eine Toilette.
good_for_groups	bool Der Ort 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 die Barrierefreiheit an einem Ort.
pure_service_area_business	bool Gibt an, ob es sich bei dem Ort um ein Unternehmen ohne festen Standort in einem Einzugsgebiet handelt. Ein 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 Adresse oder keinen Standort auf Google Maps.

AccessibilityOptions

Informationen zu den Optionen für die Barrierefreiheit an einem Ort.

Felder
wheelchair_accessible_parking	bool Es gibt einen rollstuhlgerechten Parkplatz.
wheelchair_accessible_entrance	bool Das Gebäude hat einen rollstuhlgerechten Eingang.
wheelchair_accessible_restroom	bool Es gibt ein rollstuhlgerechtes WC.
wheelchair_accessible_seating	bool Es gibt 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. Eine Adresskomponente für das Land Australien könnte beispielsweise den long_name „Australien“ haben.
short_text	string Ein abgekürzter Textname für die Adresskomponente, falls vorhanden. Eine Adresskomponente für das Land Australien könnte beispielsweise den Kurznamen „AU“ haben.
types[]	string Ein Array, das den Typ bzw. die Typen der Adresskomponente angibt.
language_code	string Die Sprache, in der diese Komponenten formatiert werden, in CLDR-Notation.

AreaSummary

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

KI-generierte Zusammenfassung der Region, in der sich der Ort befindet.

Felder
content_blocks[]	ContentBlock Inhaltsblöcke, aus denen sich die Gebietsübersicht zusammensetzt. Jeder Block hat ein eigenes Thema zu dem Gebiet.
flag_content_uri	string Ein Link, über den Nutzer ein Problem mit der Zusammenfassung melden können.

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 Geschäftsstatus des Orts.

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

ContainingPlace

Informationen zum Ort, in dem sich dieser Ort befindet.

Felder
name	string Der Ressourcenname des Orts, in dem sich dieser Ort befindet.
id	string Die Orts-ID des Orts, in dem sich dieser Ort befindet.

GenerativeSummary

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

KI-generierte Zusammenfassung des Orts.

Felder
overview	LocalizedText Die Übersicht des Orts.
overview_flag_content_uri	string Ein Link, über den Nutzer ein Problem melden können, mit der Übersichtszusammenfassung.
description	LocalizedText Die detaillierte Beschreibung des Orts.
description_flag_content_uri	string Ein Link, über den Nutzer ein Problem mit der Beschreibungsübersicht melden können.
references	References Verweise, die zum Generieren der Zusammenfassung verwendet werden.

GoogleMapsLinks

Links, mit denen verschiedene Google Maps-Aktionen ausgelöst werden.

Felder
directions_uri	string Ein Link, über den die Wegbeschreibung zum Ort angezeigt wird. Über den Link wird nur der Zielort angegeben und der Standardreisemodus DRIVE verwendet.
place_uri	string Ein Link, über den dieser Ort angezeigt werden soll.
write_a_review_uri	string Ein Link zum Schreiben einer Rezension für diesen Ort. Dieser Link wird derzeit nicht in der mobilen Version von Google Maps unterstützt und funktioniert nur in der Webversion von Google Maps.
reviews_uri	string Ein Link zu Rezensionen zu diesem Ort. Dieser Link wird derzeit nicht in der mobilen Version von Google Maps unterstützt und funktioniert nur in der Webversion von Google Maps.
photos_uri	string Ein Link zu Fotos dieses Orts. Dieser Link wird derzeit nicht in der mobilen Version von Google Maps unterstützt und funktioniert nur in der Webversion von Google Maps.

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 angeordnet, beginnend mit Sonntag in der Ortszeit. Ein leerer (aber nicht fehlender) Wert gibt an, dass ein Ort nie geöffnet ist, z.B. weil er vorübergehend wegen Renovierungsarbeiten geschlossen ist.
weekday_descriptions[]	string Lokalisierte Strings, die die Öffnungszeiten dieses Orts beschreiben, jeweils ein String für jeden Wochentag. Ist leer, wenn die Öffnungszeiten unbekannt sind oder nicht in lokalisierten Text umgewandelt werden konnten. Beispiel: „So: 18:00–06:00“
secondary_hours_type	SecondaryHoursType Ein Typstring, mit dem der Typ der Nebenstunden angegeben wird.
special_days[]	SpecialDay Strukturierte Informationen zu besonderen Tagen, die in den Zeitraum der zurückgegebenen Öffnungszeiten fallen. Als besondere Tage gelten Tage, die sich auf die Öffnungszeiten eines Ortes auswirken können, z. B. der 1. Januar. Geben Sie für „current_opening_hours“ und „current_secondary_opening_hours“ die Öffnungszeiten an, die gelten, wenn es Abweichungen gibt.
next_open_time	Timestamp Der nächste Beginn des aktuellen Zeitraums mit Öffnungszeiten liegt bis zu 7 Tage in der Zukunft. Dieses Feld wird nur ausgefüllt, wenn der Öffnungszeitenzeitraum zum Zeitpunkt der Auslieferung der Anfrage nicht aktiv ist.
next_close_time	Timestamp Das nächste Mal, wenn die aktuelle Öffnungszeit endet, bis zu 7 Tage in der Zukunft. Dieses Feld wird nur ausgefüllt, wenn der Öffnungszeitenzeitraum zum Zeitpunkt der Auslieferung der Anfrage aktiv ist.
open_now	bool Gibt an, ob der Zeitraum der Öffnungszeiten derzeit aktiv ist. Bei den 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 „jetzt geöffnet“ hat.

Felder
open	Point Die Uhrzeit, zu der der Ort geöffnet ist.
close	Point Die Uhrzeit, zu der der Ort geschlossen ist.

Punkt

Statuspunkte

Felder
date	Date Datum in der Ortszeit des Orts.
truncated	bool Gibt an, ob dieser Endpunkt gekürzt wurde oder vollständig ist. Das Kürzen erfolgt, wenn die tatsächlichen Stunden außerhalb der Zeiträume liegen, für die wir Stunden zurückgeben können. Die Stunden werden dann 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, mit dem die Art der Nebenstunden angegeben wird.

Enums
SECONDARY_HOURS_TYPE_UNSPECIFIED	Standardwert, wenn der sekundäre Stundentyp nicht angegeben ist.
DRIVE_THROUGH	Die Drive-through-Stunde 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 Brunchzeit.
PICKUP	Die Abholzeit.
ACCESS	Die Öffnungszeiten der Lagerplätze.
SENIOR_HOURS	Die speziellen Öffnungszeiten für Senioren.
ONLINE_SERVICE_HOURS	Die Online-Geschäftszeiten.

SpecialDay

Strukturierte Informationen zu besonderen Tagen, die in den Zeitraum der zurückgegebenen Öffnungszeiten fallen. Als besondere Tage gelten Tage, die sich auf die Öffnungszeiten eines Ortes auswirken können, z. B. der 1. Januar.

Felder
date	Date Das Datum dieses besonderen Tages.

ParkingOptions

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

Felder
free_parking_lot	bool Es gibt kostenlose Parkplätze.
paid_parking_lot	bool Der Ort bietet kostenpflichtige Parkplätze.
free_street_parking	bool Es gibt kostenlose Parkplätze an der Straße.
paid_street_parking	bool Es gibt gebührenpflichtige Parkplätze an der Straße.
valet_parking	bool Es gibt einen Einparkservice.
free_garage_parking	bool Das Hotel bietet kostenlose Garagenparkplätze.
paid_garage_parking	bool Es gibt gebührenpflichtige Garagenparkplätze.

PaymentOptions

Zahlungsoptionen, die vom Standort akzeptiert werden.

Felder
accepts_credit_cards	bool Kreditkarten werden als Zahlungsmittel akzeptiert.
accepts_debit_cards	bool Debitkarten werden als Zahlungsmittel akzeptiert.
accepts_cash_only	bool An diesem Ort werden nur Barzahlungen akzeptiert. Bei Orten mit diesem Attribut werden möglicherweise auch andere Zahlungsmethoden akzeptiert.
accepts_nfc	bool NFC-Zahlungen werden akzeptiert.

PlusCode

Ein Plus Code (http://plus.codes) ist ein Standortbezug mit zwei Formaten: ein globaler Code, der ein Rechteck von 14 × 14 m (1/8.000stel eines Grades) oder kleiner definiert, und ein zusammengesetzter 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 (ca. 14 × 14 Meter) darstellt.
compound_code	string Der zusammengesetzte Code des Orts, z. B. „33GV+HQ, Ramberg, Norwegen“, enthält das Suffix des globalen Codes und ersetzt das Präfix durch einen formatierten Namen einer Referenzentität.

SubDestination

Untergeordnete Ziele sind bestimmte Orte, die mit einem Hauptort verknüpft sind. Sie bieten Nutzern, die nach einem großen oder komplexen Ort suchen, wie einem Flughafen, Nationalpark, einer Universität oder einem Stadion, genauere Ziele. Untergeordnete Ziele an einem Flughafen können beispielsweise zugehörige Terminals und Parkplätze sein. Für untergeordnete Ziele werden die Orts-ID und der Name der Ortsressource zurückgegeben. Diese können in nachfolgenden Anfragen vom Typ „Place Details (New)“ verwendet werden, um umfassendere Details abzurufen, einschließlich des Anzeigenamens und des Standorts des untergeordneten Ziels.

Felder
name	string Der Ressourcenname des untergeordneten Ziels.
id	string Die Orts-ID des untergeordneten Ziels.

Polyline

Eine Polylinie für eine Route. Es wird nur eine codierte Polylinie unterstützt, die als String übergeben werden kann und eine Komprimierung mit minimalen Verlusten umfasst. Dies ist die Standardausgabe der Routes API.

Felder
Union-Feld polyline_type. Der Typ des Polyliniens. Die Standardeinstellung für die Routes API-Ausgabe ist encoded_polyline. Für polyline_type ist nur einer der folgenden Werte zulässig:
encoded_polyline	string Eine codierte Polylinie, wie sie standardmäßig von der Routes API zurückgegeben wird. Weitere Informationen finden Sie in den Tools Encoder und Decoder.

PriceLevel

Preisniveau des Orts.

Enums
PRICE_LEVEL_UNSPECIFIED	Das Preisniveau des Orts ist nicht angegeben oder unbekannt.
PRICE_LEVEL_FREE	Der Ort bietet kostenlose Dienstleistungen an.
PRICE_LEVEL_INEXPENSIVE	Der Ort bietet günstige Dienstleistungen an.
PRICE_LEVEL_MODERATE	Der Ort bietet Dienstleistungen zu günstigen Preisen an.
PRICE_LEVEL_EXPENSIVE	Der Ort bietet teure Dienstleistungen an.
PRICE_LEVEL_VERY_EXPENSIVE	Der Ort bietet sehr teure Dienstleistungen an.

PriceRange

Der Preisbereich, der mit einem Ort verknüpft ist. end_price kann auch nicht festgelegt sein, was auf einen Bereich ohne Obergrenze hinweist (z.B. „Mehr als 100 €“).

Felder
start_price	Money Der niedrigste Wert der Preisspanne (einschließlich). Der Preis muss mindestens diesem Betrag entsprechen.
end_price	Money Der höchste Preis der Preisspanne (exklusiv). Der Preis sollte unter diesem Betrag liegen.

Verweise

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

Verweis, auf den sich die generierten Inhalte beziehen.

Felder
reviews[]	Review Rezensionen, die als Referenzen dienen.
places[]	string Die Liste der Ressourcennamen der referenzierten Orte. Dieser Name kann in anderen APIs verwendet werden, die Ortsressourcennamen akzeptieren.

Überprüfen

Informationen zu einer Rezension eines Orts.

Felder
name	string Eine Referenz, die diese Rezension für einen Ort darstellt und mit der diese Rezension wiedergefunden werden kann (auch als API-Ressourcenname bezeichnet: places/{place_id}/reviews/{review}).
relative_publish_time_description	string Ein String mit einer formatierten Uhrzeit, der die Rezensionszeit relativ zur aktuellen Zeit in einer für die Sprache und das Land geeigneten Form angibt.
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 der 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 auf Google Maps angezeigt wird.

RouteModifiers

Umfasst eine Reihe optionaler Bedingungen, die bei der Berechnung der Routen erfüllt werden müssen.

Felder
avoid_tolls	bool Optional. Wenn dieser Wert auf „wahr“ gesetzt ist, werden Mautstraßen nach Möglichkeit vermieden und Routen ohne Mautstraßen bevorzugt. Gilt nur für DRIVE und TWO_WHEELER TravelMode.
avoid_highways	bool Optional. Wenn dieser Wert auf „wahr“ gesetzt ist, werden nach Möglichkeit Autobahnen vermieden und Routen ohne Autobahnen bevorzugt. Gilt nur für DRIVE und TWO_WHEELER TravelMode.
avoid_ferries	bool Optional. Wenn dieser Wert auf „wahr“ gesetzt ist, werden nach Möglichkeit Fähren vermieden und Routen ohne Fähren bevorzugt. Gilt nur für DRIVE und TWO_WHEELER TravelMode.
avoid_indoor	bool Optional. Wenn diese Option auf „wahr“ gesetzt ist, wird nach Möglichkeit die Navigation in Innenräumen vermieden. Routen ohne Navigation in Innenräumen werden bevorzugt. Gilt nur für den WALK TravelMode.

RoutingParameters

Parameter zum Konfigurieren der Routenberechnungen zu den Orten in der Antwort, sowohl entlang einer Route (wodurch die Reihenfolge der Ergebnisse beeinflusst wird) als auch zum Berechnen der Fahrtzeiten für die Ergebnisse.

Felder
origin	LatLng Optional. Ein expliziter Startpunkt für die Route, der den in der Polylinie definierten Startpunkt überschreibt. Standardmäßig wird der Polylinienursprung 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 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 Routingpriorität angegeben. Standardeinstellung ist TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE	Routen werden berechnet, ohne die aktuelle Verkehrslage zu berücksichtigen. Geeignet, wenn die Verkehrslage keine Rolle spielt oder nicht zutrifft. Mit diesem Wert wird die niedrigste Latenz erzielt. Hinweis: Bei 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	Routen werden unter Berücksichtigung der aktuellen Verkehrslage berechnet. Im Gegensatz zu TRAFFIC_AWARE_OPTIMAL werden einige Optimierungen angewendet, um die Latenz deutlich zu reduzieren.
TRAFFIC_AWARE_OPTIMAL	Die Routen werden unter Berücksichtigung der aktuellen Verkehrslage berechnet, ohne die meisten Leistungsoptimierungen anzuwenden. Bei Verwendung dieses Werts ist die Latenz am höchsten.

RoutingSummary

Dauer und Entfernung vom Startpunkt der Route zu einem Ort in der Antwort und, falls angefordert, ein zweiter Abschnitt von diesem Ort zum Ziel. Hinweis:Wenn Sie routingSummaries in die Feldmaske einfügen, ohne den Parameter routingParameters.origin oder searchAlongRouteParameters.polyline.encodedPolyline in die Anfrage aufzunehmen, führt dies zu einem Fehler.

Felder
legs[]	Leg Die einzelnen Etappen der Fahrt. Wenn Sie die Fahrzeit und Entfernung von einem festgelegten Startort berechnen, enthält legs einen einzelnen Abschnitt mit der Dauer und Entfernung vom Start- zum Zielort. Wenn Sie eine Suche entlang einer Route durchführen, enthält legs zwei Abschnitte: einen vom Start- zum Zielort und einen vom Zielort zum Ziel.
directions_uri	string Ein Link, über den eine Wegbeschreibung in Google Maps mit den Wegpunkten aus der angegebenen Routenübersicht angezeigt wird. Es kann nicht garantiert werden, dass die Route, die über diesen Link generiert wird, mit der Route übereinstimmt, die zum Generieren der Routingübersicht verwendet wurde. Der Link verwendet Informationen aus der Anfrage, z. B. aus den Feldern routingParameters und searchAlongRouteParameters, um den Link zu den Wegbeschreibungen zu generieren.

Bein

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

Felder
duration	Duration Die Zeit, die für diesen Teil der Fahrt benötigt wird.
distance_meters	int32 Die Entfernung dieses Abschnitts der Fahrt.

SearchNearbyRequest

Anfrage-Proto für die Nearby Search.

Felder
language_code	string Details zum Ort werden in der bevorzugten Sprache angezeigt, sofern verfügbar. Wenn der Sprachcode nicht angegeben oder nicht erkannt wird, können Standortdetails in einer beliebigen Sprache zurückgegeben werden. Wenn solche Details vorhanden sind, wird bevorzugt Englisch verwendet. 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. Mit diesem Parameter werden die Details zum Ort angezeigt, z. B. der regionsspezifische Ortsname, sofern verfügbar. Der Parameter kann sich auf die Ergebnisse auswirken, die gemäß anwendbarem Recht angezeigt werden. Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Dreistellige Regionscodes werden derzeit nicht unterstützt.
included_types[]	string Eingeschlossener Ortstyp (z. B. „restaurant“ oder „gas_station“) von 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 zu Konflikten kommt, d.h. ein Typ sowohl in „included_types“ als auch in „excluded_types“ enthalten ist, wird der Fehler INVALID_ARGUMENT zurückgegeben. Wenn ein Ortstyp mit mehreren Typbeschränkungen angegeben ist, 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 Dienstleistungen im Zusammenhang mit „Restaurants“, sind aber nicht in erster Linie als „Restaurants“ tätig.
excluded_types[]	string Ausgeschlossener Ortstyp (z. B. „restaurant“ oder „gas_station“) von 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 Kunde sowohl „included_types“ (z.B. „restaurant“) als auch „excluded_types“ (z.B. „cafe“) angibt, sollte die Antwort Orte enthalten, die Restaurants sind, aber keine Cafés. Die Antwort enthält Orte, die mindestens einem der „included_types“ entsprechen und keinem der „excluded_types“. Wenn es zu Konflikten kommt, d.h. ein Typ sowohl in „included_types“ als auch in „excluded_types“ enthalten ist, wird der Fehler INVALID_ARGUMENT zurückgegeben. Wenn ein Ortstyp mit mehreren Typbeschränkungen angegeben ist, 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 Dienstleistungen im Zusammenhang mit „Restaurants“, sind aber nicht in erster Linie als „Restaurants“ tätig.
included_primary_types[]	string Enthält den primären Ortstyp (z.B. „restaurant“ oder „gas_station“) von https://developers.google.com/maps/documentation/places/web-service/place-types. Ein Ort kann nur einen primären Typ aus der Tabelle „Unterstützte Typen“ haben. Es können bis zu 50 Typen aus Tabelle A angegeben werden. Wenn es zu Konflikten bei den Haupttypen kommt, d.h. ein Typ sowohl in „included_primary_types“ als auch in „excluded_primary_types“ enthalten ist, wird der Fehler INVALID_ARGUMENT zurückgegeben. Wenn ein Ortstyp mit mehreren Typbeschränkungen angegeben ist, 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 Dienstleistungen im Zusammenhang mit „Restaurants“, sind aber nicht in erster Linie als „Restaurants“ tätig.
excluded_primary_types[]	string Ausgeschlossener primärer Ortstyp (z.B. „restaurant“ oder „gas_station“) von 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 zu Konflikten bei den Haupttypen kommt, d.h. ein Typ sowohl in „included_primary_types“ als auch in „excluded_primary_types“ enthalten ist, wird der Fehler INVALID_ARGUMENT zurückgegeben. Wenn ein Ortstyp mit mehreren Typbeschränkungen angegeben ist, 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 Dienstleistungen im Zusammenhang mit „Restaurants“, sind aber nicht in erster Linie als „Restaurants“ tätig.
max_result_count	int32 Maximale Anzahl der zurückzugebenden Ergebnisse. Der Wert muss zwischen 1 und 20 (Standard) liegen. Wenn die Zahl nicht festgelegt ist, wird das Oberlimit verwendet. Wenn die Zahl negativ ist oder das Oberlimit überschreitet, wird der Fehler INVALID_ARGUMENT zurückgegeben.
location_restriction	LocationRestriction Erforderlich. Die Region, in der gesucht werden soll.
rank_preference	RankPreference Wie die Ergebnisse in der Antwort sortiert werden.
routing_parameters	RoutingParameters Optional. Parameter, die sich auf die Weiterleitung 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 ist.

RankPreference

Wie die Ergebnisse in der Antwort sortiert werden.

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

SearchNearbyResponse

Antwort-Prototyp für die Suche in der Nähe.

Felder
places[]	Place Eine Liste von Orten, die den Anforderungen des Nutzers entspricht, z. B. Ortstypen, Anzahl der Orte und spezifische Standorteinschränkungen.
routing_summaries[]	RoutingSummary Eine Liste von Routenzusammenfassungen, bei der jeder Eintrag dem entsprechenden Ort mit demselben Index im Feld places zugeordnet ist. Wenn die Zusammenfassung der Route 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, sofern erforderlich.

SearchTextRequest

Anfrage-Proto für „SearchText“.

Felder
text_query	string Erforderlich. Die Textabfrage für die Textsuche.
language_code	string Details zum Ort werden in der bevorzugten Sprache angezeigt, sofern verfügbar. Wenn der Sprachcode nicht angegeben oder nicht erkannt wird, können Standortdetails in einer beliebigen Sprache zurückgegeben werden. Wenn solche Details vorhanden sind, wird bevorzugt Englisch verwendet. 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. Mit diesem Parameter werden die Details zum Ort angezeigt, z. B. der regionsspezifische Ortsname, sofern verfügbar. Der Parameter kann sich auf die Ergebnisse auswirken, die gemäß anwendbarem Recht angezeigt werden. Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Dreistellige Regionscodes werden derzeit nicht unterstützt.
rank_preference	RankPreference Wie die Ergebnisse in der Antwort sortiert werden.
included_type	string Der angeforderte Ortstyp. Vollständige Liste der unterstützten Typen: https://developers.google.com/maps/documentation/places/web-service/place-types. Es wird nur ein eingeschlossener Typ unterstützt.
open_now	bool Damit wird die Suche auf Orte beschränkt, die derzeit geöffnet sind. Der Standardwert ist "false".
min_rating	double Ergebnisse herausfiltern, deren durchschnittliche Nutzerbewertung unter diesem Grenzwert liegt. Ein gültiger Wert muss ein Gleitkommawert zwischen 0 und 5 (einschließlich) mit einer Taktfrequenz von 0,5 sein, d. h. [0, 0,5, 1,0, …, 5,0] einschließlich. Die Eingabebewertung wird auf die nächste 0,5 aufgerundet. Bei einer Bewertung von 0,6 werden beispielsweise alle Ergebnisse mit einer Bewertung von weniger als 1,0 entfernt.
max_result_count (deprecated)	int32 Dieses Element ist veraltet. 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 in nachfolgenden Anfragen die nächste Ergebnisseite abzurufen. Wenn „0“ oder kein Wert angegeben wird, 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_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 in nachfolgenden Anfragen die nächste Ergebnisseite abzurufen. Wenn „0“ oder kein Wert angegeben wird, wird der Standardwert „20“ verwendet. Der Maximalwert ist 20. Werte über 20 werden auf 20 gesetzt. 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 diese an, um die nachfolgende Seite abzurufen. Beim Paginieren müssen alle Parameter außer page_token, page_size und max_result_count, die für „TextSearch“ bereitgestellt werden, mit dem ursprünglichen Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.
price_levels[]	PriceLevel Damit wird die Suche auf Orte beschränkt, die als bestimmte Preisstufen gekennzeichnet sind. Nutzer können beliebige Kombinationen von Preisstufen auswählen. Standardmäßig sind alle Preisstufen ausgewählt.
strict_type_filtering	bool Wird verwendet, um eine strenge Typfilterung für „included_type“ festzulegen. Wenn diese Option auf „true“ gesetzt ist, werden nur Ergebnisse desselben Typs zurückgegeben. Standardeinstellung: „false“.
location_bias	LocationBias Die Region, in der gesucht werden soll. Dieser Standort dient als Voreinstellung. 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 Standort dient als Einschränkung. Das bedeutet, dass keine Ergebnisse außerhalb des angegebenen Standorts zurückgegeben werden. Kann nicht zusammen mit „location_bias“ festgelegt werden.
ev_options	EVOptions Optional. Legen Sie die Optionen für die Suchergebnisse für Elektrofahrzeuge einer Suchanfrage für Orte fest.
routing_parameters	RoutingParameters Optional. Zusätzliche Parameter für die Weiterleitung zu Ergebnissen.
search_along_route_parameters	SearchAlongRouteParameters Optional. Zusätzliche Parameter für die Suche entlang einer Route.
include_pure_service_area_businesses	bool Optional. Fügen Sie Unternehmen ohne festen Standort in einem Einzugsgebiet hinzu, wenn das Feld auf „true“ gesetzt ist. Ein 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 Adresse oder keinen Standort auf Google Maps. Für diese Unternehmen werden keine Felder wie location, plus_code und andere standortbezogene Felder zurückgegeben.

EVOptions

Suchbare Optionen für Elektrofahrzeuge einer Suchanfrage für Orte.

Felder
minimum_charging_rate_kw	double Optional. Mindestens erforderliche Ladeleistung in Kilowatt. Ein Ort mit einem Ladepreis unter dem angegebenen Preis wird herausgefiltert.
connector_types[]	EVConnectorType Optional. Die Liste der bevorzugten Ladesteckertypen. Orte, die keinen der aufgeführten Connectortypen unterstützen, werden herausgefiltert.

LocationBias

Die Region, in der gesucht werden soll. Dieser Standort dient als Voreinstellung. 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 Südwestecke definiert ist. rectangle.high() muss der nordöstliche Punkt des Rechteck-Viewports sein. rectangle.low() muss der südwestliche Punkt des rechteckigen Ansichtsbereichs sein. rectangle.low().latitude() darf nicht größer als rectangle.high().latitude() sein. Dies führt zu einem leeren Breitengradbereich. Ein rechteckiger Ansichtsbereich darf nicht breiter als 180 Grad sein.
circle	Circle Ein Kreis, der durch Mittelpunkt und Radius definiert ist.

LocationRestriction

Die Region, in der gesucht werden soll. Dieser Standort dient als Einschränkung. Das bedeutet, dass keine Ergebnisse außerhalb des angegebenen Standorts 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 Südwestecke definiert ist. rectangle.high() muss der nordöstliche Punkt des Rechteck-Viewports sein. rectangle.low() muss der südwestliche Punkt des rechteckigen Ansichtsbereichs sein. rectangle.low().latitude() darf nicht größer als rectangle.high().latitude() sein. Dies führt zu einem leeren Breitengradbereich. Ein rechteckiger Ansichtsbereich darf nicht breiter als 180 Grad sein.

RankPreference

Wie die Ergebnisse in der Antwort sortiert werden.

Enums
RANK_PREFERENCE_UNSPECIFIED	Bei einer kategorischen Suchanfrage wie „Restaurants in New York City“ ist RELEVANZ standardmäßig festgelegt. Bei nicht kategorischen Suchanfragen wie „Mountain View, CA“ empfehlen wir, die Einstellung „rankPreference“ deaktiviert zu lassen.
DISTANCE	Die Ergebnisse werden nach Entfernung sortiert.
RELEVANCE	Die Ergebnisse werden nach Relevanz sortiert. Die Sortierreihenfolge wird durch den normalen Ranking-Stack bestimmt.

SearchAlongRouteParameters

Gibt eine vordefinierte Polylinie aus der Routes API an, die die zu suchende Route definiert. Die Suche entlang einer Route ähnelt der Verwendung der Anfrageoption locationBias oder locationRestriction, um die Suchergebnisse zu beeinflussen. Mit den Optionen locationBias und locationRestriction können Sie jedoch eine Region angeben, um die Suchergebnisse zu beeinflussen. Mit dieser Option können Sie die Ergebnisse entlang einer Fahrtroute beeinflussen.

Die Ergebnisse befinden sich nicht unbedingt entlang der angegebenen Route, sondern werden im Suchbereich, der durch die Polylinie und optional durch locationBias oder locationRestriction definiert ist, anhand der minimalen Umwege vom Start- zum Zielort sortiert. Die Ergebnisse können entlang einer alternativen Route liegen, insbesondere wenn die angegebene Polylinie keine optimale Route vom Start- zum Zielort definiert.

Felder
polyline	Polyline Erforderlich. Die Polylinie der Route.

SearchTextResponse

Antwort-Proto für „SearchText“.

Felder
places[]	Place Eine Liste von Orten, die den Suchkriterien des Nutzers entsprechen.
routing_summaries[]	RoutingSummary Eine Liste von Routenzusammenfassungen, bei der jeder Eintrag dem entsprechenden Ort mit demselben Index im Feld places zugeordnet ist. Wenn die Zusammenfassung der Route für einen der Orte nicht verfügbar ist, enthält sie einen leeren Eintrag. Diese Liste enthält bei Bedarf so viele Einträge wie die Liste der Orte.
contextual_contents[]	ContextualContent Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Eine Liste mit kontextbezogenen Inhalten, bei der jeder Eintrag dem entsprechenden Ort im selben Index im Feld „Orte“ zugeordnet ist. Vorzugsweise werden Inhalte verwendet, die für die text_query in der Anfrage relevant sind. Wenn die kontextbezogenen Inhalte für einen der Orte nicht verfügbar sind, werden nicht kontextbezogene Inhalte zurückgegeben. Es ist nur dann leer, wenn die Inhalte für diesen Ort nicht verfügbar sind. Diese Liste enthält bei Bedarf so viele Einträge wie die Liste der Orte.
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 Textabfrage wie in der Anfrage in Google Maps suchen.

TravelMode

Optionen für die Mobilitätsform Diese Optionen entsprechen den Angeboten der Routes API.

Enums
TRAVEL_MODE_UNSPECIFIED	Es wurde kein Verkehrsmittel angegeben. Die Standardeinstellung ist DRIVE.
DRIVE	Mit dem Pkw unterwegs sein
BICYCLE	Mit dem Fahrrad fahren Nicht unterstützt mit search_along_route_parameters.
WALK	Sie gehen zu Fuß. Nicht unterstützt mit search_along_route_parameters.
TWO_WHEELER	Motorisierte Zweiräder aller Art, z. B. Motorroller und Motorräder. Dieser Mobilitätsmodus unterscheidet sich von BICYCLE, der für von Menschen angetriebene Fortbewegungsmittel steht. Nicht unterstützt mit search_along_route_parameters. Nur in den Ländern unterstützt, die unter Länder und Regionen, die bei Zweirädern möglich sind aufgeführt sind.