Package google.maps.geocode.v4alpha

Index

DestinationService

Ein Dienst zum Abrufen von Zielen.

Ein Ziel liefert hierarchischen Kontext zu einem Ort. So können Sie beispielsweise Apartmentgebäude innerhalb eines größeren Apartmentkomplexes finden und umgekehrt. Außerdem werden Navigationspunkte bereitgestellt, die für Anwendungsfälle wie Mitfahrgelegenheiten oder Lieferungen geeignet sind.

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

Diese Methode führt eine Zielsuche durch und gibt eine Liste von Zielen zurück.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

GeocodeService

Ein Dienst zum Ausführen von Geocoding.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

Mit dieser Methode wird eine Adresse geocodiert, d. h. einer Adresse wird ein LatLng-Wert zugeordnet. Außerdem werden strukturierte Informationen zur Adresse bereitgestellt.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address
GeocodeLocation

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

Mit dieser Methode wird ein Standort geocodiert, d. h. ein LatLng-Wert wird einer Adresse zugeordnet. Außerdem werden strukturierte Informationen zur Adresse bereitgestellt.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location
GeocodePlace

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

Bei dieser Methode wird eine Geocoding-Suche mit einer Orts-ID durchgeführt.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Ziel

Ein Ziel Dazu gehören der Hauptort, zugehörige Orte, Eingänge und Navigationspunkte.

Felder
primary

PlaceView

Der primäre Ort, der durch die primary_query in der Anfrage identifiziert wird.

containing_places[]

PlaceView

Die weniger genauen Orte, die den primären Ort enthalten. Beispiel: der Apartmentkomplex, zu dem dieses Gebäude gehört.

sub_destinations[]

PlaceView

Genauere Unterziele des primären Ortes. Beispiel: Einheiten in einem Gebäude.

Hinweis: Im Vergleich zu den von der Places API zurückgegebenen SubDestination-Objekten ist diese Liste von Unterzielen umfassender und jedes Unterziel enthält mehr Informationen.

landmarks[]

Landmark

Orientierungspunkte, die verwendet werden können, um zu kommunizieren, wo sich das Ziel befindet, oder um die Ankunft zu erleichtern.

entrances[]

Entrance

Eingänge für dieses Ziel.

navigation_points[]

NavigationPoint

Navigationspunkte für dieses Ziel.

parking_options

Destination.ParkingOptions

Parkmöglichkeiten für dieses Ziel.

arrival_summary

Destination.ArrivalSummary

KI-generierte Zusammenfassung der Ankunft am Zielort.

ArrivalSummary

KI-generierte Zusammenfassung der Ankunft am Zielort.

Felder
text

LocalizedText

Die Zusammenfassung der Ankunft am Zielort.

flag_content_url

string

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

disclosure_text

LocalizedText

Nur Ausgabe. Enthält den Offenlegungstext für die Ankunftszusammenfassung.

ParkingOptions

Informationen zu Parkmöglichkeiten am Zielort.

Felder
availability

Destination.ParkingOptions.Availability

Die Verfügbarkeit von Parkplätzen für dieses Ziel.

parking_facilities[]

Destination.ParkingOptions.ParkingFacility

Die Parkmöglichkeiten für dieses Ziel.

onsite_parking

bool

Am Zielort stehen Parkplätze für Besucher/Kunden zur Verfügung.

free_parking_lot

bool

Kostenlose Parkplätze sind vorhanden.

paid_parking_lot

bool

Gebührenpflichtige Parkplätze sind vorhanden.

free_street_parking

bool

Kostenlose Parkplätze an der Straße sind verfügbar.

paid_street_parking

bool

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

valet_parking

bool

Einparkservice vorhanden

free_garage_parking

bool

Kostenlose Garagenparkplätze sind vorhanden.

paid_garage_parking

bool

Gebührenpflichtige Parkplätze im Parkhaus

Verfügbarkeit

Ein aggregierter Wert, der angibt, wie schwierig es ist, einen Parkplatz zu finden, wenn man diesen Ort besucht.

In Zukunft werden möglicherweise neue Werte hinzugefügt.

Enums
AVAILABILITY_UNSPECIFIED Es sind keine Informationen zur Verfügbarkeit von Parkplätzen vorhanden.
PLENTY Es sind ausreichend Parkplätze vorhanden.
SOMEWHAT_DIFFICULT Es ist eher schwierig, einen Parkplatz zu finden.
DIFFICULT Es ist sehr schwierig, einen Parkplatz zu finden.

ParkingFacility

Eine einzelne, separate Parkmöglichkeit (z.B. ein bestimmtes Parkhaus oder ein bestimmter Parkplatz), die mit dem Ziel verknüpft ist. Hier finden Sie detaillierte Informationen zu einer bestimmten Parkeinrichtung, während die übergeordnete ParkingOptions-Nachricht eine aggregierte Zusammenfassung aller verfügbaren Parkmöglichkeiten enthält.

Felder
place

PlaceView

Die Ortsdarstellung dieser bestimmten Parkeinrichtung.

onsite

bool

Gibt an, ob sich diese Parkmöglichkeit am Hauptziel befindet. Wenn dieses Feld nicht festgelegt ist, ist der Status vor Ort unbekannt.

popular

bool

Gibt an, ob diese Parkeinrichtung bei Besuchern, die zum Hauptziel reisen, beliebt ist. Wenn dieses Feld nicht festgelegt ist, ist der Beliebtheitsstatus unbekannt.

straight_line_distance_meters

double

Die Luftlinie in Metern vom Hauptziel zu dieser Parkmöglichkeit.

Eingang

Ein Eingang ist ein einzelnes Koordinatenpaar aus Breiten- und Längengrad, das die Position eines Ein- und Ausgangs für einen Ort definiert.

Felder
display_name

LocalizedText

Menschenlesbarer Name, z.B. „Tor B“, „Südeingang“, „Eingang 5th Ave“.

location

LatLng

Der Standort des Eingangs.

tags[]

Entrance.Tag

Eine Liste von Tags, die den Eingang beschreiben.

place

string

Das Gebäude, in dem sich dieser Eingang befindet, im Format places/{place_id}.

street_view_thumbnail

StreetViewThumbnail

Street View-Miniaturansicht, die den Eingang zeigt. Das Bild kann über die Street View Static API angefordert werden. Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/streetview/request-streetview.

street_view_annotation

ImageAnnotation

Anmerkung des Eingangs auf der oben zurückgegebenen street_view_thumbnail.

Tag

Merkmale, die einen Eingang beschreiben.

Enums
TAG_UNSPECIFIED Nicht verwendet.
PREFERRED

Der Eingang bietet wahrscheinlich physischen Zugang zum Hauptort am zurückgegebenen Ziel. Ein Ort kann mehrere bevorzugte Eingänge haben. Wenn ein Eingang dieses Tag nicht hat, befindet er sich zwar physisch im selben Gebäude wie der Hauptort, bietet aber nicht unbedingt Zugang zu diesem Ort.

Wenn der primäre Ort beispielsweise ein Restaurant in einem Einkaufszentrum ist, sind die „PREFERRED“-Eingänge diejenigen, die wahrscheinlich in das Restaurant selbst führen. Die anderen zurückgegebenen Eingänge sind andere Eingänge des Gebäudes, z. B. Eingänge zu anderen Restaurants im Einkaufszentrum.

Wenn der Hauptort ein Gebäude ist, sind die PREFERRED-Eingänge diejenigen, die in den „Hauptteil“ des Gebäudes führen. In einem Einkaufszentrum sind die PREFERRED-Eingänge beispielsweise diejenigen, die Zugang zum Hauptfoyer bieten. Wenn ein Eingang jedoch nur Zugang zu einem Geschäft an der Seite des Gebäudes bietet, ist es kein PREFERRED-Eingang.

Hinweis: Ein PREFERRED-Eingang bietet möglicherweise keinen Zugang zum Hauptort und ein nicht PREFERRED-Eingang bietet möglicherweise Zugang zum Hauptort.

GeocodeAddressRequest

Anfragenachricht für GeocodeService.GeocodeAddress.

Felder
location_bias

GeocodeAddressRequest.LocationBias

Optional. Die Region, in der gesucht werden soll. Dieser Standort dient als Gewichtung, d. h., Ergebnisse in der Nähe des angegebenen Standorts werden bevorzugt.

language_code

string

Optional. Sprache, in der die Ergebnisse zurückgegeben werden sollen.

region_code

string

Optional. Regionscode. Der Regionscode, angegeben als zweistelliger Wert für die länderspezifische Top-Level-Domain (ccTLD). Der Parameter wirkt sich auf die Ergebnisse gemäß geltendem Recht aus. Durch diesen Parameter werden die Ergebnisse des Dienstes zwar beeinflusst, aber nicht vollständig eingeschränkt.

Union-Feld address_input. Die Adresse, die geocodiert werden soll. Für address_input ist nur einer der folgenden Werte zulässig:
address_query

string

Die unstrukturierte Adresse, die geocodiert werden soll.

address

PostalAddress

Die strukturierte Adresse, die im Postadressenformat geocodiert werden soll.

LocationBias

Die Region, in der gesucht werden soll. Dieser Standort dient als Gewichtung, d. h., Ergebnisse in der Nähe des angegebenen Standorts werden bevorzugt.

Felder
Union-Feld type. Arten von standortbezogenen Verzerrungen Für type ist nur einer der folgenden Werte zulässig:
rectangle

Viewport

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

GeocodeAddressResponse

Antwortnachricht für GeocodeService.GeocodeAddress.

Felder
results[]

GeocodeResult

Das Geocoding-Ergebnis.

GeocodeLocationRequest

Anfragenachricht für GeocodeService.GeocodeLocation.

Felder
language_code

string

Optional. Sprache, in der die Ergebnisse zurückgegeben werden sollen.

region_code

string

Optional. Regionscode. Der Regionscode, angegeben als zweistelliger Wert für die länderspezifische Top-Level-Domain (ccTLD). Der Parameter wirkt sich auf die Ergebnisse gemäß geltendem Recht aus.

types[]

string

Optional. Eine Reihe von Typ-Tags, um die Ergebnisse einzuschränken. Ergebnisse, die keinen der angegebenen Typen haben, werden entfernt.

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.

granularity[]

GeocodeResult.Granularity

Optional. Ein Filter mit einem oder mehreren Enums für die Standortgranularität.

Union-Feld location_input. Der zu geocodierende Ort. Für location_input ist nur einer der folgenden Werte zulässig:
location_query

string

Der Standort im Format „lat,lng“. Beispiel: „64.7611872,-18.4705364“.

location

LatLng

Der Standort im strukturierten Format.

GeocodeLocationResponse

Antwortnachricht für GeocodeService.GeocodeLocation.

Felder
results[]

GeocodeResult

Das Geocoding-Ergebnis.

plus_code

PlusCode

Plus Code des Standorts in der Anfrage.

GeocodePlaceRequest

Anfragenachricht für GeocodeService.GeocodePlace.

Felder
place

string

Erforderlich. Orts-ID für die Geocodierung im Format „places/{place}“.

language_code

string

Optional. Sprache, in der die Ergebnisse zurückgegeben werden sollen.

region_code

string

Optional. Regionscode. Der Regionscode, angegeben als zweistelliger Wert für die länderspezifische Top-Level-Domain (ccTLD). Der Parameter wirkt sich auf die Ergebnisse gemäß geltendem Recht aus.

GeocodeResult

Ein Geocoding-Ergebnis enthält geografische Informationen zu einem Ort.

Felder
place

string

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

place_id

string

Die eindeutige Kennung eines Ortes.

location

LatLng

Die LatLng-Koordinaten dieser Adresse.

granularity

GeocodeResult.Granularity

Die Granularität des Standorts.

viewport

Viewport

Ein Darstellungsbereich, der für die Anzeige des Geocoding-Ergebnisses geeignet ist.

bounds

Viewport

Ein Begrenzungsrahmen für die Adresse.

formatted_address

string

Die einzeilige formatierte Adresse.

postal_address

PostalAddress

Die Adresse im Postanschriftformat.

address_components[]

GeocodeResult.AddressComponent

Wiederholte Komponenten für jede Ortsebene.

postal_code_localities[]

LocalizedText

Vollständige Liste der Orte, die zur Postleitzahl gehören.

Dieses Feld wird nur ausgefüllt, wenn das Ergebnis vom Typ „postal_code“ ist.

types[]

string

Eine Reihe von Typ-Tags für dieses Ergebnis. Beispiel: „political“ und „administrative_area“.

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.

plus_code

PlusCode

Plus Code des Standorts in diesem Geocode.

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 langen Namen „Australien“ 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 Kurznamen „AU“ haben.

types[]

string

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

Diese Werte stammen aus der Tabelle mit Adresstypen und Adresskomponententypen, die von der Places API verwendet wird: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types

language_code

string

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

Detaillierungsgrad

Die Granularität des Standorts.

Enums
GRANULARITY_UNSPECIFIED Nicht verwenden.
ROOFTOP Der nicht interpolierte Standort eines tatsächlichen Grundstücks, das der übereinstimmenden Adresse entspricht.
RANGE_INTERPOLATED Aus einem Bereich von Hausnummern interpoliert. Wenn wir beispielsweise wissen, dass ein Abschnitt des Amphitheatre Pkwy die Hausnummern 1600–1699 enthält, wird die Hausnummer 1650 möglicherweise in der Mitte zwischen den Endpunkten platziert.
GEOMETRIC_CENTER Der geometrische Mittelpunkt eines Elements, für das wir Polygondaten haben.
APPROXIMATE Alles andere.

ImageAnnotation

Eine Annotation auf einem Vorschaubild, z. B. ein Polygon, das einen Eingang umreißt.

Felder
coordinates[]

ImageAnnotation.Coordinate

Eine Liste von Koordinaten, die ein Polygon auf dem Bild bilden. Die Koordinaten sind gegen den Uhrzeigersinn sortiert.

Coordinate

Pixelkoordinate eines Punkts im Bild. Der Ursprung (0,0) ist die obere linke Ecke des oberen linken Pixels des Bildes, wobei die x-Achse nach rechts und die y-Achse nach unten zeigt.

Felder
x_px

float

X-Koordinate

y_px

float

Y-Koordinate

Sehenswürdigkeit

Orientierungspunkte werden verwendet, um zu kommunizieren, wo sich das Ziel befindet, oder um das Erreichen des Ziels zu erleichtern.

Felder
relational_description

LocalizedText

Eine menschenlesbare Beschreibung, wie das Ziel mit der Sehenswürdigkeit zusammenhängt. Beispiel: „In der Nähe des Empire State Building“ oder „Gegenüber dem Weißen Haus“.

tags[]

Landmark.Tag

Tags, die beschreiben, wie die Landmarke im Kontext des Ziels verwendet werden kann.

straight_line_distance_meters

double

Nur Ausgabe. Die Luftlinie von dieser Sehenswürdigkeit zum Ziel in Metern.

travel_distance_meters

double

Nur Ausgabe. Die Entfernung von diesem Orientierungspunkt zum Ziel in Metern.

Union-Feld landmark. Die Sehenswürdigkeit. Für landmark ist nur einer der folgenden Werte zulässig:
place

PlaceView

Der Ort, der diese Sehenswürdigkeit darstellt.

Tag

Die Liste aller möglichen Tags, die beschreiben, wie eine Sehenswürdigkeit im Kontext eines Reiseziels verwendet werden kann.

Wenn eine Adresse sowohl das Tag ADDRESS als auch das Tag ARRIVAL hat, bedeutet das, dass die Sehenswürdigkeit sowohl lokal bekannt als auch in der Nähe des Ziels ist.

Enums
TAG_UNSPECIFIED Nicht verwendet.
ADDRESS Ein lokal bekannter Ort, der verwendet werden kann, um den ungefähren Standort des Ziels zu ermitteln. In der Regel innerhalb weniger hundert Meter vom Ziel entfernt. Diese ähneln den Sehenswürdigkeiten, die von der Funktion „Adressdeskriptoren“ der Geocoding API zurückgegeben werden: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL Ein Ort, der als Orientierungshilfe dient, um das Ziel zu erreichen. Nützlich für die Navigation, wenn Sie sich in der Nähe des Ziels befinden. Diese Landmarke kann sich beispielsweise auf der gegenüberliegenden Straßenseite des Ziels befinden. Ein Orientierungspunkt mit diesem Tag ist in der Regel näher am Ziel als Orientierungspunkte mit dem Tag ADDRESS.

Ein Navigationspunkt ist ein Ort neben einer Straße, an dem die Navigation enden kann.

Felder
navigation_point_token

string

Nur Ausgabe. Ein Token, mit dem dieser Navigationspunkt identifiziert werden kann.

display_name

LocalizedText

Der Anzeigename dieses Navigationspunkts. Beispiel: „5th Ave“ oder „Gate B“.

location

LatLng

Ein Punkt neben dem Straßenabschnitt, an dem die Navigation enden soll. Der Punkt ist absichtlich leicht von der Mittellinie der Straße versetzt, um die Straßenseite, auf der sich der Ort befindet, klar zu kennzeichnen.

travel_modes[]

NavigationPoint.TravelMode

Mobilitätsformen, die für diesen Navigationspunkt geeignet sind.

usages[]

NavigationPoint.Usage

Listet die von diesem Navigationspunkt unterstützten usages auf. Wenn das Feld leer ist, bedeutet das nicht unbedingt, dass die Nutzung in irgendeiner Weise eingeschränkt ist. Alle Navigationspunkte können für die allgemeine Navigation verwendet werden.

street_view_thumbnail

StreetViewThumbnail

Street View-Miniaturansicht, die den Navigationspunkt zeigt, falls verfügbar. Das Bild kann über die Street View Static API angefordert werden. Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/streetview/request-streetview.

entrance_annotation

ImageAnnotation

Anmerkung des Eingangs, der mit diesem Navigationspunkt auf der oben zurückgegebenen street_view_thumbnail verknüpft ist, falls verfügbar.

altitude_meters

float

Die Höhe des Navigationspunkts in Metern relativ zum WGS-84-Ellipsoid.

TravelMode

Mobilitätsformen, die für diesen Navigationspunkt geeignet sind.

Enums
TRAVEL_MODE_UNSPECIFIED Nicht verwendet.
DRIVE Zum Autofahren geeignet.
WALK Zum Spazierengehen geeignet.

Nutzung

Von diesem Navigationspunkt unterstützte Verwendungen. In Zukunft werden möglicherweise neue Werte hinzugefügt.

Enums
USAGE_UNSPECIFIED Nicht verwendet.
UNKNOWN Gibt an, dass der Nutzungstyp unbekannt ist.
DROPOFF Geeignet, um einen Fahrgast abzusetzen. Beispiel: ein Ausstiegsort für Mitfahrgelegenheiten.
PICKUP Geeignet, um einen Fahrgast abzuholen. Beispiel: Abholort für eine Mitfahrgelegenheit.
PARKING Zum Parken geeignet. Beispielsweise auf einem Parkplatz.

PlaceView

Stellt eine Ansicht eines Ortes in der Places API dar. Außerdem werden zusätzliche Informationen zu Zielen bereitgestellt, z. B. der Strukturtyp und das Anzeigepolygon.

In einigen Fällen kann sich ein PlaceView mit derselben Orts-ID von dem unterscheiden, was von der Places API für die Felder types und display_name zurückgegeben wird.

Felder
place

string

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

place_id

string

Die eindeutige Kennung eines Ortes.

display_name

LocalizedText

Menschenlesbare Beschreibung des Ortes. Beispiel: „Gate B“, „McDonalds“

primary_type

string

Der primäre Ortstyp dieses Orts. Eine Liste der möglichen Werte finden Sie unter https://developers.google.com/maps/documentation/places/web-service/place-types.

Hinweis: Dieses Feld ist nicht immer ausgefüllt. Seien Sie darauf vorbereitet, in solchen Situationen das Feld types zu verwenden.

types[]

string

Alle mit diesem Ort verknüpften Ortstypen. Eine Liste der möglichen Werte finden Sie unter https://developers.google.com/maps/documentation/places/web-service/place-types.

formatted_address

string

Einzeilige Adresse.

postal_address

PostalAddress

Strukturierte Adresse.

structure_type

PlaceView.StructureType

Der Typ des Gebäudes, das diesem Ort entspricht.

location

LatLng

Der Standort dieses Ortes. Bei Orten mit Anzeigepolygonen kann dies ein guter Ort sein, um eine Markierung auf der Karte zu platzieren.

display_polygon

Struct

Der Polygonumriss des Ortes im GeoJSON-Format gemäß RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

Hinweis: Das RFC 7946-Format unterstützt MultiPolygons, sodass ein display_polygon-Objekt mehrere Polygone darstellen kann.

address_components[]

PlaceView.AddressComponent

Wiederholte Komponenten für jede Ortsebene.

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 langen Namen „Australien“ 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 Kurznamen „AU“ haben.

types[]

string

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

Diese Werte stammen aus der Tabelle mit Adresstypen und Adresskomponententypen, die von der Places API verwendet wird: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types

language_code

string

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

StructureType

Der Typ der Struktur, die dieser Ort darstellt.

Enums
STRUCTURE_TYPE_UNSPECIFIED Nicht verwendet.
POINT Ein Punktstandort.
SECTION Ein Unterabschnitt eines Gebäudes.
BUILDING Ein Gebäude.
GROUNDS Ein großes Gebiet, das in der Regel mehrere Gebäude umfasst, z. B. ein Universitätscampus, ein Apartmentkomplex oder ein Einkaufszentrum.

PlusCode

Ein Plus Code (http://plus.codes) ist ein Standortverweis in zwei Formaten: ein globaler Code, der ein Rechteck von 14 m × 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 Ortes, 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.

SearchDestinationsRequest

Anfragenachricht für DestinationService.SearchDestinations.

Felder
travel_modes[]

NavigationPoint.TravelMode

Optional. Die Mobilitätsformen, nach denen Navigationspunkte gefiltert werden sollen. Dies wirkt sich auf das Feld navigation_points aus, das in der Antwort zurückgegeben wird. Wenn leer, werden Navigationspunkte aller Mobilitätsformen zurückgegeben.

language_code

string

Optional. Sprache, in der die Ergebnisse zurückgegeben werden sollen.

region_code

string

Optional. Regionscode. Der Regionscode, angegeben als zweistelliger Wert für die länderspezifische Top-Level-Domain (ccTLD). Der Parameter wirkt sich auf die Ergebnisse gemäß geltendem Recht aus. Durch diesen Parameter werden die Ergebnisse des Dienstes zwar beeinflusst, aber nicht vollständig eingeschränkt.

Union-Feld primary_query. Fragen Sie das primäre Ziel ab. Das kann ein Ort, eine vollständig angegebene Adresse oder ein LatLng-Standort sein. Einige Orte und Adressen mit minimalen Informationen können nicht in ein Ziel umgewandelt werden.

Die Ziele werden um die angegebene Primärabfrage herum erstellt.

Hinweis: Es werden nur Orte und Adressen unterstützt, die als Navigationsziel verwendet werden können. Beispielsweise kann ein Ort, der ein Haus oder einen Apartmentkomplex darstellt, als Primärabfrage verwendet werden, Orte, die eine Ortschaft oder ein Verwaltungsgebiet darstellen, jedoch nicht. Für primary_query ist nur einer der folgenden Werte zulässig:

place

string

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

address_query

SearchDestinationsRequest.AddressQuery

Eine Adresse.

location_query

SearchDestinationsRequest.LocationQuery

Ein genauer Standort.

AddressQuery

Die Adresse, nach der Sie suchen möchten. Geben Sie Adressen im vom Postdienst des jeweiligen Landes verwendeten Format an.

Felder
Union-Feld kind. Die Adressabfrage. Für kind ist nur einer der folgenden Werte zulässig:
address

PostalAddress

Eine Adresse im Postanschriftformat.

address_query

string

Eine Adresse, die als einzelne Zeile formatiert ist.

LocationQuery

Eine Standortabfrage, um ein primäres Ziel in der Nähe zu ermitteln.

Hinweis: Wenn sich die Standortabfrage innerhalb eines Gebäudes mit Untergebäuden befindet, kann es sein, dass der zurückgegebene primäre Ort ein Untergebäude ist. In diesen Fällen enthält das Feld containing_places das Gebäude.

Felder
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

Optional. Filter, die auf Zielkandidaten angewendet werden sollen.

Union-Feld kind. Die Standortabfrage. Für kind ist nur einer der folgenden Werte zulässig:
location

LatLng

Ein genauer LatLng-Standort.

PlaceFilter

Filter, die auf Zielkandidaten angewendet werden sollen.

Felder
structure_type

PlaceView.StructureType

Optional. Wenn angegeben, haben alle Ziele garantiert einen primären Ort mit diesem Strukturtyp. Dies kann dazu führen, dass einige Ziele herausgefiltert werden oder die zurückgegebenen Ziele vergröbert oder verfeinert werden.

Wenn beispielsweise GROUNDS angegeben ist, haben alle zurückgegebenen Ziele einen primären Ort mit dem Strukturtyp GROUNDS. Dies kann dazu führen, dass einige Ziele, die nicht Teil eines Geländes sind, herausgefiltert werden oder dass die zurückgegebenen Ziele auf die Ebene des Geländes vergröbert werden.

Dieses Feld kann auch verwendet werden, um Polygone für die Gebäudedarstellung einfacher zu extrahieren. Wenn beispielsweise BUILDING angegeben ist, wird das Anzeigepolygon des primären Orts für das Gebäude am angegebenen Standort verwendet.

addressability

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

Optional. Wenn angegeben, werden nur Ziele zurückgegeben, die die entsprechenden Adressierbarkeitskriterien erfüllen.

Adressierbarkeit

Definiert Optionen für die Filterung nach Adressierbarkeit. In Zukunft werden möglicherweise neue Werte hinzugefügt.

Enums
ADDRESSABILITY_UNSPECIFIED Wenn nichts angegeben ist, wählt der Dienst einen sinnvollen Standardwert aus.
ANY Die Adressierbarkeit ist kein Filterkriterium. Ziele werden unabhängig von ihrer Adressierbarkeit zurückgegeben.
PRIMARY Alle zurückgegebenen Ziele haben einen primären Ort mit einer Adresse auf Straßenebene oder einem Namen.
WEAK Alle zurückgegebenen Ziele haben entweder einen Hauptort oder ein Unterziel mit einer Adresse oder einem Namen auf Straßenebene.

SearchDestinationsResponse

Antwortnachricht für DestinationService.SearchDestinations.

Felder
destinations[]

Destination

Eine Liste der Ziele.

Der Dienst gibt ein Ergebnis zurück, wenn ein primäres Ziel eindeutig aus der primären Abfrage identifiziert werden kann. Andernfalls gibt der Dienst möglicherweise mehrere Ergebnisse zur Mehrdeutigkeitsauflösung oder gar keine Ergebnisse zurück.

StreetViewThumbnail

Parameter für die Darstellung einer Google Street View-Miniaturansicht. Mit diesen Parametern können Sie ein Street View-Bild von der Street View Static API anfordern. Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/streetview/request-streetview.

Felder
pano

string

Eine bestimmte Panorama-ID.

width_px

int32

Breite des Ausgabe-Thumbnail-Bildes in Pixeln. Hinweis: Wenn Sie Annotations zusammen mit dem Thumbnail anfordern, müssen diese Höhen- und Breitenwerte in der Street View API-Anfrage verwendet werden, damit die Koordinaten der Annotations korrekt mit dem Bild übereinstimmen.

height_px

int32

Höhe des Ausgabe-Miniaturansichtsbilds in Pixeln. Hinweis: Wenn Sie Annotations zusammen mit dem Thumbnail anfordern, müssen diese Höhen- und Breitenwerte in der Street View API-Anfrage verwendet werden, damit die Koordinaten der Annotations korrekt mit dem Bild übereinstimmen.

heading_degree

float

Horizontale Ausrichtung der Kamera in Grad. Bereich [0, 360). 0 steht für Norden und 90 für Osten.

pitch_degree

float

Vertikale Ausrichtung der Kamera in Grad. Bereich [-90, 90]. 0 ist der Horizont, +90 ist senkrecht nach oben, -90 ist senkrecht nach unten.

fov_degree

float

Horizontales Sichtfeld in Grad. Bereich (0, 180]. Steuert die Zoomstufe. Ein kleineres Sichtfeld bedeutet mehr Zoom.