Geocoder

Geocoder-Klasse

google.maps.Geocoder-Klasse

Ein Dienst zur Konvertierung zwischen einer Adresse und einer LatLng.

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

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

GeocoderRequest

google.maps.GeocoderRequest-Schnittstelle

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

address optional
Typ:string optional
Zu geocodierende Adresse Nur eine der folgenden Optionen muss angegeben werden: address, location und placeId.
bounds optional
LatLngBounds, innerhalb derer gesucht werden soll. Optional.
componentRestrictions optional
Komponenten werden verwendet, um die Ergebnisse auf einen bestimmten Bereich zu beschränken. Ein Filter besteht aus einem oder mehreren der folgenden Filter: 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
Eine Sprachkennzeichnung für die Sprache, in der die Ergebnisse zurückgegeben werden sollen, falls 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 durch. Weitere Informationen finden Sie unter Umgekehrte Geocodierung. Nur eine der folgenden Optionen muss angegeben werden: address, location und placeId.
placeId optional
Typ:string optional
Die Orts-ID des Standorts. 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 Places API-Entwicklerleitfaden. Der Geocoder führt eine umgekehrte Geocodierung durch. Weitere Informationen finden Sie unter Umgekehrte Geocodierung. Nur eine der folgenden Optionen muss angegeben werden: address, location und placeId.
region optional
Typ:string optional
Ländercode zur Verzerrung der Suche, angegeben als zweistelliger (nicht numerischer) Subcode für die Unicode-Region / CLDR-Kennung. Optional. Informationen zu den unterstützten Regionen finden Sie unter Details zur Google Maps Platform-Abdeckung.

Schnittstelle GeocoderComponentRestrictions

google.maps.GeocoderComponentRestrictions-Schnittstelle

GeocoderComponentRestrictions steht für eine Reihe von Filtern, die in einen bestimmten Bereich aufgelöst werden. Weitere Informationen zur Funktionsweise finden Sie unter Filter für 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
Entspricht dem langen oder kurzen Namen einer route. Optional.

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 Aufrufen von const {GeocoderStatus} = await google.maps.importLibrary("geocoding"). 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 diese GeocoderRequest wurde kein Ergebnis gefunden.

Schnittstelle GeocoderResponse

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.

Schnittstelle GeocoderResult

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, jedoch 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 mit der für Menschen lesbaren Adresse dieses Standorts.
geometry
Ein GeocoderGeometry-Objekt
place_id
Typ:string
Die Orts-ID des Standorts. 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 Entwicklerleitfaden 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 zugeordnet werden konnte. Bei einer genauen Übereinstimmung lautet der Wert undefined.
plus_code optional
Typ:PlacePlusCode optional
Der Plus Code für den Standort.
postcode_localities optional
Typ:Array<string> optional
Ein String-Array, das alle Orte in einer Postleitzahl angibt. 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 String-Array, das den Typ dieser Adresskomponente angibt. Eine Liste der gültigen Typen finden Sie hier.

Schnittstelle GeocoderGeometry

google.maps.GeocoderGeometry-Schnittstelle

Geometrieinformationen zu diesem GeocoderResult

location
Typ:LatLng
Die Breitengrad/Längengrad-Koordinaten dieses Ergebnisses.
location_type
Der Typ des in location zurückgegebenen Standorts
viewport
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 Aufrufen von const {GeocoderLocationType} = await google.maps.importLibrary("geocoding"). 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.