Geocoder

Geocoder-Klasse

google.maps.Geocoder Klasse

Ein Dienst zum Konvertieren zwischen einer Adresse und einer LatLng.

Zugriff durch Anrufen von const {Geocoder} = await google.maps.importLibrary("geocoding").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Konstruktor
Geocoder	Geocoder() Parameter:Keine Erstellt eine neue Instanz von Geocoder, die Geocode-Anfragen an Google-Server sendet.

Methoden
geocode	geocode(request[, callback]) Parameter: request:  GeocoderRequest callback:  function(Array<GeocoderResult> optional, GeocoderStatus): void optional Rückgabewert:Promise<GeocoderResponse> Geocodieren einer Anforderung.

GeocoderRequest-Schnittstelle

google.maps.GeocoderRequest-Schnittstelle

Die Spezifikation für eine Geocoding-Anfrage, die an Geocoder gesendet werden soll.

Attribute
address optional	Typ:string optional Zu geocodierende Adresse Es muss genau einer der Werte address, location und placeId angegeben werden.
bounds optional	Typ:LatLngBounds|LatLngBoundsLiteral optional LatLngBounds, in dem gesucht werden soll. Optional.
componentRestrictions optional	Typ:GeocoderComponentRestrictions optional Mit Komponenten können Sie die Ergebnisse auf einen bestimmten Bereich eingrenzen. Ein Filter besteht aus einem oder mehreren der folgenden Elemente: route, locality, administrativeArea, postalCode, country. Es werden nur Ergebnisse zurückgegeben, die mit allen Filtern übereinstimmen. Die Filterwerte unterstützen dieselben Methoden für Rechtschreibkorrektur und partielle Übereinstimmung wie andere Geocoding-Anforderungen. Optional.
extraComputations optional	Hinweis:Nur im v=beta-Kanal verfügbar. Typ:Array<ExtraGeocodeComputation> optional Eine Liste zusätzlicher Berechnungen, die zum Ausführen der Anfrage verwendet werden können. Hinweis: Durch diese zusätzlichen Berechnungen können zusätzliche Felder in der Antwort zurückgegeben werden.
fulfillOnZeroResults optional	Typ:boolean optional Führen Sie die Zusage bei einem ZERO_RESULT-Status in der Antwort aus. Das kann sinnvoll sein, da auch bei null Geocoding-Ergebnissen möglicherweise zusätzliche Felder auf Antwortebene zurückgegeben werden.
language optional	Typ:string optional Eine Sprach-ID für die Sprache, in der Ergebnisse nach Möglichkeit zurückgegeben werden sollen. Hier finden Sie eine Liste der unterstützten Sprachen.
location optional	Typ:LatLng|LatLngLiteral optional LatLng (oder LatLngLiteral), nach dem gesucht werden soll. Vom Geocoder wird eine umgekehrte Geocodierung ausgeführt. Weitere Informationen zur umgekehrten Geocodierung Es muss genau einer der Werte address, location und placeId angegeben werden.
placeId optional	Typ:string optional Die Orts-ID, die mit dem Standort verknüpft ist. Mit einer Orts-ID wird ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert. Weitere Informationen zu Orts-IDs finden Sie im Entwicklerleitfaden für die Places API. Vom Geocoder wird eine umgekehrte Geocodierung ausgeführt. Weitere Informationen zur umgekehrten Geocodierung Es muss genau einer der Werte address, location und placeId angegeben werden.
region optional	Typ:string optional Der Ländercode, der verwendet wird, um die Suche zu beeinflussen. Er wird als zweistelliges (nicht numerisches) untergeordnetes Unicode-Tag für Regionen / CLDR-Kennung angegeben. Optional. Welche Regionen unterstützt werden, sehen Sie in den Details zur Google Maps Platform-Abdeckung.

GeocoderComponentRestrictions-Schnittstelle

google.maps.GeocoderComponentRestrictions-Schnittstelle

GeocoderComponentRestrictions steht für eine Reihe von Filtern, die in einem bestimmten Bereich aufgelöst werden. Weitere Informationen zur Funktionsweise finden Sie unter Geocoding-Komponenten filtern.

Attribute
administrativeArea optional	Typ:string optional Entspricht allen administrative_area levels. Optional.
country optional	Typ:string optional Gleicht einen Ländernamen oder einen aus 2 Buchstaben bestehenden ISO 3166-1-Ländercode ab. Optional.
locality optional	Typ:string optional Sucht nach einer Übereinstimmung mit den Typen locality und sublocality. Optional.
postalCode optional	Typ:string optional Entspricht postal_code und postal_code_prefix. Optional.
route optional	Typ:string optional Gleicht den langen oder kurzen Namen eines route ab. Optional.

ExtraGeocodeComputation-Konstanten

google.maps.ExtraGeocodeComputation Konstanten

Hinweis:Nur im v=beta-Kanal verfügbar.

Zusätzliche Berechnungen, die beim Ausführen einer Geocoding-Anfrage durchgeführt werden sollen.

Zugriff durch Anrufen von const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Konstanten
ADDRESS_DESCRIPTORS	Adressdeskriptor generieren

GeocoderStatus-Konstanten

google.maps.GeocoderStatus Konstanten

Der Status, der von Geocoder nach Abschluss eines Aufrufs von geocode() zurückgegeben wird. Geben Sie diese nach Wert oder mit dem Namen der Konstante an. Beispiel: 'OK' oder google.maps.GeocoderStatus.OK.

Zugriff durch Anrufen von const {GeocoderStatus} = await google.maps.importLibrary("geocoding").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Konstanten
ERROR	Beim Aufbau der Verbindung zu den Google-Servern ist ein Problem aufgetreten.
INVALID_REQUEST	Dieses GeocoderRequest war ungültig.
OK	Die Antwort enthält ein gültiges GeocoderResponse.
OVER_QUERY_LIMIT	Die Anfragebeschränkungen wurden von der Webseite in einem zu geringen Zeitraum überschritten.
REQUEST_DENIED	Es ist der Webpage nicht gestattet, den Geocoder zu verwenden.
UNKNOWN_ERROR	Eine Geocodierungsanfrage konnte aufgrund eines Serverfehlers nicht verarbeitet werden. Die Anfrage ist möglicherweise erfolgreich, wenn Sie es erneut versuchen.
ZERO_RESULTS	Für diese GeocoderRequest wurde kein Ergebnis gefunden.

GeocoderResponse-Schnittstelle

google.maps.GeocoderResponse-Schnittstelle

Eine Geocoder-Antwort, die von Geocoder zurückgegeben wird und die Liste der GeocoderResults enthält.

Attribute
results	Typ:Array<GeocoderResult> Die Liste der GeocoderResults.
address_descriptor optional	Hinweis:Nur im v=beta-Kanal verfügbar. Typ:AddressDescriptor optional Eine relationale Beschreibung eines Standorts. Enthält eine Liste der Sehenswürdigkeiten in der Nähe und der Gebiete, in denen sich der Zielort befindet. Sie wird nur für Reverse-Geocoding-Anfragen und nur dann ausgefüllt, wenn ExtraGeocodeComputation.ADDRESS_DESCRIPTORS aktiviert ist.
plus_code optional	Typ:PlacePlusCode optional Der Plus Code, der dem Standort zugeordnet ist.

GeocoderResult-Schnittstelle

google.maps.GeocoderResult-Schnittstelle

Ein einzelnes Geocodierer-Ergebnis, das vom Geocode-Server abgerufen wurde. Eine Geocode-Anfrage kann mehrere Ergebnisobjekte zurückgeben. Dieses Ergebnis ist zwar „JSON-ähnlich“, aber nicht streng JSON, da es indirekt ein LatLng-Objekt enthält.

Attribute
address_components	Typ:Array<GeocoderAddressComponent> Ein Array von GeocoderAddressComponent
formatted_address	Typ:string Ein String, der die Adresse dieses Ortes in visuell lesbarer Form enthält.
geometry	Typ:GeocoderGeometry Ein GeocoderGeometry-Objekt
place_id	Typ:string Die Orts-ID, die mit dem Standort verknüpft ist. Mit einer Orts-ID wird ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert. Weitere Informationen zu Orts-IDs finden Sie im Entwicklerleitfaden für die Places API.
types	Typ:Array<string> Ein Array mit Zeichenfolgen, die die Typen der zurückgegebenen geocodierten Elemente bezeichnen. Eine Liste der möglichen Strings finden Sie im Abschnitt Typen von Adresskomponenten im Entwicklerhandbuch.
address_descriptor optional	Hinweis:Nur im v=beta-Kanal verfügbar. Typ:AddressDescriptor optional Eine relationale Beschreibung des Standorts, der mit diesem Geocode verknüpft ist. Enthält eine Liste der Sehenswürdigkeiten in der Nähe und der Gebiete, in denen sich der Zielort befindet. Dieses Feld wird nur für Anfragen zur Geocodierung und zum Nachschlagen von Orts-IDs ausgefüllt, nur wenn ExtraGeocodeComputation.ADDRESS_DESCRIPTORS aktiviert ist und nur für bestimmte lokalisierte Orte.
partial_match optional	Typ:boolean optional Gibt an, ob der Geocoder keine genaue Übereinstimmung für die ursprüngliche Anfrage zurückgegeben hat, obwohl ein Teil der angeforderten Adresse zugeordnet werden konnte. Bei einer genauen Übereinstimmung ist der Wert undefined.
plus_code optional	Typ:PlacePlusCode optional Der Plus Code, der dem Standort zugeordnet ist.
postcode_localities optional	Typ:Array<string> optional Ein Array von Strings, das alle Orte umfasst, die zu einer Postleitzahl gehören. Das Array ist nur vorhanden, wenn das Ergebnis eine Postleitzahl mit mehreren Orten ist.

AddressDescriptor-Schnittstelle

google.maps.AddressDescriptor-Schnittstelle

Hinweis:Nur im v=beta-Kanal verfügbar.

Eine relationale Beschreibung eines Standorts. Enthält eine Liste der Sehenswürdigkeiten in der Nähe und der Gebiete, in denen sich der Zielort befindet.

Attribute
areas	Typ:Array<Area> Eine sortierte Liste mit angrenzenden oder benachbarten Bereichen. Die nützlichsten (erkennbaren und präzisen) Bereiche werden zuerst aufgeführt.
landmarks	Typ:Array<Landmark> Eine sortierte Liste von Sehenswürdigkeiten in der Nähe. Die nützlichsten (erkennbaren und in der Nähe befindlichen) Orientierungspunkte werden zuerst aufgeführt.

GeocoderAddressComponent-Schnittstelle

google.maps.GeocoderAddressComponent-Schnittstelle

Eine einzelne Adresskomponente innerhalb von GeocoderResult. Eine vollständige Adresse kann aus mehreren Adresskomponenten bestehen.

Attribute
long_name	Typ:string Der vollständige Text der Adresskomponente.
short_name	Typ:string Der abgekürzte Text der angegebenen Adresskomponente.
types	Typ:Array<string> Ein Array von Strings, das den Typ dieser Adresskomponente angibt. Eine Liste der gültigen Typen finden Sie hier.

GeocoderGeometry-Schnittstelle

google.maps.GeocoderGeometry-Schnittstelle

Geometrieinformationen zu diesem GeocoderResult

Attribute
location	Typ:LatLng Die Breitengrad/Längengrad-Koordinaten dieses Ergebnisses.
location_type	Typ:GeocoderLocationType Der in location zurückgegebene Standorttyp
viewport	Typ:LatLngBounds Die Grenzen des empfohlenen Darstellungsbereichs für die Anzeige dieses GeocoderResult
bounds optional	Typ:LatLngBounds optional Die genauen Grenzen dieses GeocoderResult, falls zutreffend

GeocoderLocationType-Konstanten

google.maps.GeocoderLocationType Konstanten

Beschreibt den Typ der Position, die nach einer Geocodierung zurückgegeben wird. Geben Sie diese nach Wert oder mit dem Namen der Konstante an. Beispiel: 'ROOFTOP' oder google.maps.GeocoderLocationType.ROOFTOP.

Zugriff durch Anrufen von const {GeocoderLocationType} = await google.maps.importLibrary("geocoding").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Konstanten
APPROXIMATE	Das zurückgegebene Ergebnis ist ein Näherungswert.
GEOMETRIC_CENTER	Das zurückgegebene Ergebnis ist die geometrische Mitte eines Ergebnisses wie einer Linie (zum Beispiel einer Straße) oder eines Polygons (einer Region).
RANGE_INTERPOLATED	Das zurückgegebene Ergebnis stellt eine Näherung dar (normalerweise auf einer Straße), die zwischen zwei präzise lokalisierten Punkten (wie z. B. Kreuzungen) interpoliert wurde. Interpolierte Ergebnisse werden üblicherweise dann zurückgegeben, wenn hausnummern-genaue Geocodierungen für eine Adresse in einer Straße nicht zur Verfügung stehen.
ROOFTOP	Das zurückgegebene Ergebnis stellt eine präzise Geocodierung dar.

Landmark-Schnittstelle

google.maps.Landmark-Schnittstelle

Hinweis:Nur im v=beta-Kanal verfügbar.

Ein Ort, der einen Bezugspunkt für die Adresse darstellt.

Attribute
display_name	Typ:string Der Name des Orientierungspunkts.
display_name_language_code	Typ:string Die Sprache des Namens für das Wahrzeichen.
place_id	Typ:string Die Orts-ID des zugrunde liegenden Betriebs, der als Landmarke dient. Kann verwendet werden, um weitere Informationen zum Wahrzeichen über „Place Details“ oder „Place ID Lookup“ abzurufen.
spatial_relationship	Typ:SpatialRelationship Definiert die räumliche Beziehung zwischen dem Zielort und dem Orientierungspunkt.
straight_line_distance_meters	Typ:number Die Luftlinie zwischen dem Zielort und dem Orientierungspunkt.
types	Typ:Array<string> Ein oder mehrere Werte, die den Typ des zurückgegebenen Ergebnisses angeben. Weitere Informationen finden Sie unter Typen .
travel_distance_meters optional	Typ:number optional Die Entfernung entlang des Straßennetzes zwischen dem Zielort und dem Orientierungspunkt. Dieses Feld kann leer sein, wenn das Landmark von dem Teil des Straßennetzes getrennt ist, der dem Ziel am nächsten liegt, oder wenn der Zielort nicht als Teil des Straßennetzes betrachtet wurde.

Area-Schnittstelle

google.maps.Area-Schnittstelle

Hinweis:Nur im v=beta-Kanal verfügbar.

Ein Ort, der eine kleine Region wie ein Stadtteil, ein nicht eigenständiger Ort oder ein großer Komplex ist, der den Zielort enthält.

Attribute
containment	Typ:Containment Definiert die räumliche Beziehung zwischen dem Zielort und dem Gebiet.
display_name	Typ:string Der Name des Bereichs.
display_name_language_code	Typ:string Die Sprache des Namens für das Gebiet.
place_id	Typ:string Die Orts-ID des zugrunde liegenden Gebiets. Kann verwendet werden, um weitere Informationen zum Gebiet über „Place Details“ oder „Place ID Lookup“ abzurufen.

Begrenzungskonstanten

google.maps.Containment Konstanten

Hinweis:Nur im v=beta-Kanal verfügbar.

Ein Enum, das die räumliche Beziehung zwischen dem Bereich und dem Zielort darstellt.

Zugriff durch Anrufen von const {Containment} = await google.maps.importLibrary("geocoding").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Konstanten
NEAR	Der Zielort liegt außerhalb der Region, aber in der Nähe.
OUTSKIRTS	Der Zielstandort befindet sich in der Region, in der sich das Gebiet befindet, in der Nähe des Rands.
WITHIN	Der Zielstandort befindet sich in der Nähe des Zentrums der Region.

SpatialRelationship-Konstanten

google.maps.SpatialRelationship Konstanten

Hinweis:Nur im v=beta-Kanal verfügbar.

Ein Enum, das die räumliche Beziehung zwischen dem Orientierungspunkt und dem Ziel darstellt.

Zugriff durch Anrufen von const {SpatialRelationship} = await google.maps.importLibrary("geocoding").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

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