Geocoder

Geocoder-Klasse

google.maps.Geocoder Klasse

Ein Dienst zum Konvertieren zwischen einer Adresse und einer LatLng.

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

Geocoder
Geocoder()
Parameter:Keine
Erstellt eine neue Instanz eines Geocoder-Objekts, das Geocodierungsanfragen an Google-Server sendet.
geocode
geocode(request[, callback])
Parameter:
Rückgabewert:  Promise<GeocoderResponse>
Geocodieren einer Anforderung.

GeocoderRequest-Schnittstelle

google.maps.GeocoderRequest-Schnittstelle

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

address optional
Typ:string optional
Zu geocodierende Adresse Es muss jeweils nur eines davon angegeben werden: address, location und placeId.
bounds optional
LatLngBounds, in dem gesucht werden soll. Optional.
componentRestrictions optional
Komponenten werden verwendet, um Ergebnisse auf einen bestimmten Bereich einzuschränken. 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.
BetaextraComputations optional
Eine Liste zusätzlicher Berechnungen, die zum Ausführen der Anfrage verwendet werden können. Hinweis: Diese zusätzlichen Berechnungen geben möglicherweise zusätzliche Felder für die Antwort zurück.
fulfillOnZeroResults optional
Typ:boolean optional
Erfüllen Sie das Versprechen mit dem Status ZERO_Result (Null) in der Antwort. Dies kann gewünscht werden, da auch ohne Geocoding-Ergebnisse zusätzliche Felder auf Antwortebene zurückgegeben werden können.
language optional
Typ:string optional
Ein Sprachbezeichner 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. Der Geocoder führt eine umgekehrte Geocodierung durch. Weitere Informationen finden Sie unter Umgekehrte Geocodierung. Es muss jeweils nur eines davon angegeben werden: address, location und placeId.
placeId optional
Typ:string optional
Die mit dem Standort verknüpfte Orts-ID. 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. Der Geocoder führt eine umgekehrte Geocodierung durch. Weitere Informationen finden Sie unter Umgekehrte Geocodierung. Es muss jeweils nur eines davon angegeben werden: address, location und placeId.
region optional
Typ:string optional
Ländercode zur Gewichtung der Suche, angegeben als zweistelliges (nicht numerisches) untergeordnetes Unicode-Tag / CLDR-Kennung für die Region. Optional. Informationen zu unterstützten Regionen finden 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 einen bestimmten Bereich aufgelöst werden. Weitere Informationen dazu finden Sie unter Filtern von Geocoding-Komponenten.

administrativeArea optional
Typ:string optional
Stimmt mit allen administrative_area levels überein. Optional.
country optional
Typ:string optional
Entspricht einem Ländernamen oder einem aus zwei Buchstaben bestehenden ISO 3166-1-Ländercode. Optional.
locality optional
Typ:string optional
Übereinstimmung mit den Typen locality und sublocality. Optional.
postalCode optional
Typ:string optional
Stimmt mit postal_code und postal_code_prefix überein. Optional.
route optional
Typ:string optional
Stimmt mit dem langen oder Kurznamen eines route überein. Optional.

ExtraGeocodeComputation-Konstanten

google.maps.ExtraGeocodeComputation-Konstanten

Zusätzliche Berechnungen, die während der Ausführung einer Geocoding-Anfrage ausgeführt werden müssen.

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

ADDRESS_DESCRIPTORS Erstellen Sie einen Adressdeskriptor.

GeocoderStatus-Konstanten

google.maps.GeocoderStatus-Konstanten

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

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

ERROR Bei der Verbindungsherstellung zu den Google-Servern ist ein Problem aufgetreten.
INVALID_REQUEST GeocoderRequest war ungültig.
OK Die Antwort enthält eine gültige 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 sie noch einmal ausführen.
ZERO_RESULTS Für dieses Gerät (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.

results
Die Liste der GeocoderResults.
Betaaddress_descriptor optional
Typ:AddressDescriptor optional
Eine relationale Beschreibung eines Standorts. Enthält eine Rangliste nahe gelegener Sehenswürdigkeiten und die Gebiete, in denen sich die Zielregion befindet. Es wird nur für umgekehrte Geocoding-Anfragen und nur dann ausgefüllt, wenn ExtraGeocodeComputation.ADDRESS_DESCRIPTORS aktiviert ist.
plus_code optional
Typ:PlacePlusCode optional
Der mit dem Standort verknüpfte Plus Code

GeocoderResult-Schnittstelle

google.maps.GeocoderResult-Schnittstelle

Ein einzelnes Geocodierer-Ergebnis, das vom Geocode-Server abgerufen wurde. Eine Geocode-Anfrage kann mehrere Ergebnisobjekte zurückgeben. Beachten Sie, dass das Ergebnis "JSON-ähnlich" ist, aber nicht ganz genau JSON entspricht, da es indirekt ein LatLng-Objekt enthält.

address_components
Ein Array mit GeocoderAddressComponent-Werten
formatted_address
Typ:string
Ein String, der die Adresse dieses Ortes in visuell lesbarer Form enthält.
geometry
Ein GeocoderGeometry-Objekt
place_id
Typ:string
Die mit dem Standort verknüpfte Orts-ID. 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 möglicher Strings finden Sie im Entwicklerhandbuch im Abschnitt Adresskomponententypen.
Betaaddress_descriptor optional
Typ:AddressDescriptor optional
Eine relationale Beschreibung des Standorts, der diesem Geocode zugeordnet ist. Enthält eine Rangliste nahe gelegener Sehenswürdigkeiten und die Gebiete, in denen sich die Zielregion befindet. Dieses Feld wird nur für Forward Geocoding und Anfragen für eine Orts-ID-Suche ausgefüllt, 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 abgeglichen werden konnte. Bei einer genauen Übereinstimmung lautet der Wert undefined.
plus_code optional
Typ:PlacePlusCode optional
Der mit dem Standort verknüpfte Plus Code
postcode_localities optional
Typ:Array<string> optional
Ein Array von Strings, die alle Orte in einer Postleitzahl angeben. Das Array ist nur vorhanden, wenn das Ergebnis eine Postleitzahl mit mehreren Orten ist.

AddressDescriptor-Schnittstelle

google.maps.AddressDescriptor-Schnittstelle

Eine relationale Beschreibung eines Standorts. Enthält eine Rangliste nahe gelegener Sehenswürdigkeiten und die Gebiete, in denen sich die Zielregion befindet.

areas
Typ:Array<Area>
Eine Rangliste mit Gebieten oder angrenzenden Gebieten. Die nützlichsten (erkennbaren und präzisesten) Gebiete werden an erster Stelle aufgeführt.
landmarks
Eine Rangliste nahe gelegener Sehenswürdigkeiten. Die nützlichsten (erkennbaren und in der Nähe befindlichen) Sehenswürdigkeiten werden zuerst aufgeführt.

GeocoderAddressComponent-Schnittstelle.

google.maps.GeocoderAddressComponent-Schnittstelle

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

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 Zeichenfolgen, die den Typ dieser Adresskomponente angeben. Eine Liste der gültigen Typen findest du hier.

GeocoderGeometry-Schnittstelle.

google.maps.GeocoderGeometry-Schnittstelle

Geometrische Informationen zu GeocoderResult

location
Typ:LatLng
Die Breitengrad/Längengrad-Koordinaten dieses Ergebnisses.
location_type
Der in location zurückgegebene Standorttyp
viewport
Die Grenzen des empfohlenen Darstellungsbereichs für die Anzeige dieses GeocoderResults
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 mit dem Wert oder dem Namen der Konstante an. Beispiel: 'ROOFTOP' oder google.maps.GeocoderLocationType.ROOFTOP.

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

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 zurückgegeben, wenn präzise Geocodes für eine Postanschrift nicht verfügbar sind.
ROOFTOP Das zurückgegebene Ergebnis stellt eine präzise Geocodierung dar.

Landmark-Benutzeroberfläche

google.maps.Landmark-Schnittstelle

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

display_name
Typ:string
Der Name der Sehenswürdigkeit.
display_name_language_code
Typ:string
Die Sprache des Namens der Sehenswürdigkeit.
place_id
Typ:string
Die Orts-ID der zugrunde liegenden Einrichtung, die als Orientierungspunkt dient. Kann verwendet werden, um weitere Informationen zur Sehenswürdigkeit über „Place Details“ oder „Place ID Lookup“ aufzulösen.
spatial_relationship
Definiert die räumliche Beziehung zwischen der Zielregion und der Sehenswürdigkeit.
straight_line_distance_meters
Typ:number
Die Luftlinie zwischen der Zielregion und der Sehenswürdigkeit.
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 Strecke, die im Straßennetz zwischen der Zielregion und der Sehenswürdigkeit zurückgelegt wird. Dieses Feld kann leer sein, wenn die Sehenswürdigkeit von dem Teil des Straßennetzes getrennt ist, der dem Ziel am nächsten liegt, ODER wenn die Zielregion nicht als Teil des Straßennetzes angesehen wurde.

Area-Schnittstelle

google.maps.Area-Schnittstelle

Ein Ort, der eine kleine Region ist, z. B. ein Stadtteil, ein Unterortsteil oder ein großes Komplex mit der Zielregion.

containment
Definiert die räumliche Beziehung zwischen der Zielregion und dem Gebiet.
display_name
Typ:string
Der Name des Gebiets.
display_name_language_code
Typ:string
Die Sprache des Namens für das Gebiet.
place_id
Typ:string
Die Orts-ID des zugrunde liegenden Bereichs. Kann verwendet werden, um weitere Informationen über das Gebiet über eine Place Details- oder Place ID-Suche aufzulösen.

Begrenzungskonstanten

google.maps.Containment-Konstanten

Ein enum-Wert, der die räumliche Beziehung zwischen dem Gebiet und der Zielregion darstellt.

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

NEAR Die Zielregion liegt außerhalb der Region, aber in der Nähe.
OUTSKIRTS Die Zielregion liegt innerhalb der Region, nah am Rand.
WITHIN Die Zielregion liegt innerhalb der Region, nahe am Mittelpunkt.

SpatialRelationship-Konstanten

google.maps.SpatialRelationship-Konstanten

Ein Enum-Wert, der die raumbezogene Beziehung zwischen der Sehenswürdigkeit und dem Ziel darstellt.

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

ACROSS_THE_ROAD Das Ziel befindet sich direkt gegenüber der Sehenswürdigkeit auf der anderen Straßenseite.
AROUND_THE_CORNER Nicht auf der gleichen Route wie die Sehenswürdigkeit, sondern nur eine Abzweigung.
BEHIND In der Nähe der Sehenswürdigkeit, aber weiter vom Zugangspunkt entfernt
BESIDE Das Ziel liegt direkt neben der Sehenswürdigkeit.
DOWN_THE_ROAD Sie befinden sich auf derselben Route wie die Sehenswürdigkeit, aber nicht neben oder auf der anderen Seite.
NEAR Dies ist die Standardbeziehung, wenn nichts spezifischeres unten zutrifft.
WITHIN Die Sehenswürdigkeit hat eine räumliche Geometrie und das Ziel liegt innerhalb der Grenzen.