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

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.

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

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.