Geocoder

Geocoder-Klasse

google.maps.Geocoder Kurs

Ein Dienst zum Umwandeln zwischen einer Adresse und einer LatLng.

Rufe const {Geocoder} = await google.maps.importLibrary("geocoding") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Geocoder
Geocoder()
Parameter:Keine
Erstellt eine neue Instanz eines Geocoder, das Geocode-Anfragen an Google-Server sendet.
geocode
geocode(request[, callback])
Parameter: 
Rückgabewert:Promise<GeocoderResponse>
Geocodieren einer Anforderung.

GeocoderRequest-Schnittstelle

google.maps.GeocoderRequest Benutzeroberfläche

Die Spezifikation für eine Geocoding-Anfrage, die an den Geocoder gesendet werden soll.
address optional
Typ:string optional
Zu geocodierende Adresse Es muss genau eines von address, location und placeId angegeben werden.
bounds optional
LatLngBounds, in dem gesucht werden soll. Optional.
componentRestrictions optional
Mithilfe von Komponenten können Sie die Ergebnisse auf einen bestimmten Bereich eingrenzen. Ein Filter besteht aus einem oder mehreren der folgenden Werte: 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 können zusätzliche Felder in der Antwort zurückgeben.
fulfillOnZeroResults optional
Typ:boolean optional
Erfülle die Zusicherung für den Status „ZERO_RESULT“ in der Antwort. 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 Sprachkennzeichnung für die Sprache, in der die Ergebnisse zurückgegeben werden sollen, sofern möglich. 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 aus. Weitere Informationen finden Sie unter Umgekehrte Geocodierung. Es muss genau eines von 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 Entwicklerhandbuch für die Places API. Der Geocoder führt eine umgekehrte Geocodierung aus. Weitere Informationen finden Sie unter Umgekehrte Geocodierung. Es muss genau eines von address, location und placeId angegeben werden.
region optional
Typ:string optional
Ländercode, mit dem die Suche beeinflusst wird, angegeben als zweistelliges (nicht numerisches) untergeordnetes Unicode-Tag für Regionen / CLDR-ID. Optional. Welche Regionen unterstützt werden, sehen Sie in den Details zur Google Maps Platform-Abdeckung.

GeocoderComponentRestrictions-Schnittstelle

google.maps.GeocoderComponentRestrictions Benutzeroberfläche

GeocoderComponentRestrictions steht für eine Reihe von Filtern, die auf einen bestimmten Bereich zurückzuführen sind. 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
Gleicht einem Ländernamen oder einem aus zwei Buchstaben bestehenden ISO 3166-1-Ländercode ab. Optional.
locality optional
Typ:string optional
Er entspricht sowohl locality- als auch sublocality-Typen. Optional.
postalCode optional
Typ:string optional
Entspricht postal_code und postal_code_prefix. Optional.
route optional
Typ:string optional
Gleicht dem langen oder Kurznamen einer route ab. Optional.

Konstanten für ExtraGeocodeComputation

google.maps.ExtraGeocodeComputation constants

Zusätzliche Berechnungen, die beim Ausführen einer Geocodierungsanfrage ausgeführt werden.

Rufe const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
ADDRESS_DESCRIPTORS Einen Adressdeskriptor generieren

Konstanten für GeocoderStatus

google.maps.GeocoderStatus constants

Der Status, der von der Geocoder nach Abschluss eines Aufrufs von geocode() zurückgegeben wird. Geben Sie diese Werte anhand des Werts oder des Namens der Konstante an. Beispiel: 'OK' oder google.maps.GeocoderStatus.OK.

Rufe const {GeocoderStatus} = await google.maps.importLibrary("geocoding") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
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 wurden keine Ergebnisse gefunden.

GeocoderResponse-Schnittstelle

google.maps.GeocoderResponse Benutzeroberfläche

Eine Geocoder-Antwort, die vom Geocoder zurückgegeben wird und die Liste der GeocoderResults enthält.
results
Die Liste der GeocoderResult.
Betaaddress_descriptor optional
Typ:AddressDescriptor optional
Eine relationale Beschreibung eines Standorts. Enthält eine Rangfolge von Sehenswürdigkeiten in der Nähe und die Gebiete, in denen sich der Zielort befindet. Sie wird nur für Anfragen zum Rückwärtsgeocodieren und nur dann ausgefüllt, wenn ExtraGeocodeComputation.ADDRESS_DESCRIPTORS aktiviert ist.
plus_code optional
Typ:PlacePlusCode optional
Der Plus Code, der mit dem Standort verknüpft ist.

GeocoderResult-Schnittstelle

google.maps.GeocoderResult Benutzeroberfläche

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 genommen JSON, da es indirekt ein LatLng-Objekt enthält.
address_components
Ein Array von GeocoderAddressComponents
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 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 möglicher Strings finden Sie im Entwicklerhandbuch im Abschnitt Adresskomponententypen.
Betaaddress_descriptor optional
Typ:AddressDescriptor optional
Eine relationale Beschreibung des Standorts, der mit diesem Geocode verknüpft ist. Enthält eine Rangfolge von Sehenswürdigkeiten in der Nähe und die Gebiete, in denen sich der Zielort befindet. Dieser Wert wird nur für Anfragen zur Vorwärtsgeocodierung und zur Orts-ID-Suche, nur wenn ExtraGeocodeComputation.ADDRESS_DESCRIPTORS aktiviert ist, und nur für bestimmte lokalisierte Orte ausgefüllt.
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 mit dem Standort verknüpft 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 Benutzeroberfläche

Eine relationale Beschreibung eines Standorts. Enthält eine Rangfolge von Sehenswürdigkeiten in der Nähe und die Gebiete, in denen sich der Zielort befindet.
areas
Typ:Array<Area>
Eine sortierte Liste von enthaltenen oder benachbarten Gebieten. Die nützlichsten (erkennbaren und präzisen) Bereiche werden zuerst eingestuft.
landmarks
Eine nach Rang sortierte Liste von Sehenswürdigkeiten in der Nähe. Die nützlichsten (erkennbaren und nahe gelegenen) Markierungen werden zuerst angezeigt.

GeocoderAddressComponent-Schnittstelle

google.maps.GeocoderAddressComponent Benutzeroberfläche

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 Strings, das den Typ dieser Adresskomponente angibt. Eine Liste der gültigen Typen finden Sie hier.

GeocoderGeometry-Schnittstelle

google.maps.GeocoderGeometry Benutzeroberfläche

Geometrische Informationen zu diesem GeocoderResult
location
Typ:LatLng
Die Breitengrad/Längengrad-Koordinaten dieses Ergebnisses.
location_type
Der in location zurückgegebene Standorttyp
viewport
Die Begrenzungen des empfohlenen Darstellungsbereichs für die Anzeige dieses GeocoderResult
bounds optional
Typ:LatLngBounds optional
Die genauen Grenzen dieser GeocoderResult, sofern zutreffend

Konstanten vom Typ GeocoderLocationType

google.maps.GeocoderLocationType constants

Beschreibt den Typ der Position, die nach einer Geocodierung zurückgegeben wird. Geben Sie diese Werte anhand des Werts oder des Namens der Konstante an. Beispiel: 'ROOFTOP' oder google.maps.GeocoderLocationType.ROOFTOP.

Rufe const {GeocoderLocationType} = await google.maps.importLibrary("geocoding") auf, um auf die Daten zuzugreifen. 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 ü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-Oberfläche

google.maps.Landmark Benutzeroberfläche

Ein Ort, der als Bezugspunkt für die Adresse dient.
display_name
Typ:string
Der Name des Wahrzeichens.
display_name_language_code
Typ:string
Die Sprache des Namens des Wahrzeichens.
place_id
Typ:string
Die Orts-ID der zugrunde liegenden Einrichtung, die als Wahrzeichen dient. Kann verwendet werden, um über „Place Details“ oder „Place ID Lookup“ weitere Informationen zum Wahrzeichen abzurufen.
spatial_relationship
Definiert die räumliche Beziehung zwischen dem Zielort und dem Markierungspunkt.
straight_line_distance_meters
Typ:number
Die Entfernung in gerader Linie zwischen dem Zielort und dem Wahrzeichen.
types
Typ:Array<string>
Einer 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 zurückgelegte Strecke entlang des Straßennetzes zwischen dem Zielort und dem Wahrzeichen. Dieser Wert kann leer sein, wenn das Wahrzeichen nicht mit dem Teil des Straßennetzes verbunden ist, dem das Ziel am nächsten ist, ODER wenn der Zielort nicht als Teil des Straßennetzes betrachtet wurde.

Flächendiagramm

google.maps.Area Benutzeroberfläche

Ein Ort, der eine kleine Region ist, z. B. ein Stadtteil, ein Ortsteil oder ein großer Komplex, in dem sich der Zielort befindet.
containment
Definiert die räumliche Beziehung zwischen dem Zielort und dem Gebiet.
display_name
Typ:string
Der Name der Region.
display_name_language_code
Typ:string
Die Sprache des Namens der Region.
place_id
Typ:string
Die Orts-ID des zugrunde liegenden Gebiets. Kann verwendet werden, um über „Place Details“ oder „Place ID Lookup“ weitere Informationen zum Gebiet abzurufen.

Begrenzungskonstanten

google.maps.Containment constants

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

Rufe const {Containment} = await google.maps.importLibrary("geocoding") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
NEAR Der Zielort liegt außerhalb des Gebiets, aber in der Nähe.
OUTSKIRTS Der Zielort befindet sich innerhalb des Gebiets, nahe am Rand.
WITHIN Der Zielstandort befindet sich in der Gebietsregion, nahe dem Zentrum.

Konstanten von SpatialRelationship

google.maps.SpatialRelationship constants

Ein Enum, das die räumliche Beziehung zwischen dem Markierungspunkt und dem Ziel angibt.

Rufe const {SpatialRelationship} = await google.maps.importLibrary("geocoding") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
ACROSS_THE_ROAD Das Ziel befindet sich direkt gegenüber dem markanten Punkt auf der anderen Straßenseite.
AROUND_THE_CORNER Nicht auf derselben Route wie das Wahrzeichen, aber nur eine Kurve entfernt.
BEHIND Nah am Gebäude der Sehenswürdigkeit, aber weiter vom Zugangspunkt entfernt.
BESIDE Das Ziel befindet sich direkt neben dem Wahrzeichen.
DOWN_THE_ROAD Sie muss sich auf derselben Route wie das Wahrzeichen befinden, aber nicht daneben oder darüber.
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.