Method: geocode.address.geocodeAddress
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Mit dieser Methode wird eine Adressengeocodierung durchgeführt, bei der eine Adresse einem LatLng zugeordnet wird. Außerdem werden strukturierte Informationen zur Adresse bereitgestellt.
HTTP-Anfrage
GET https://geocode.googleapis.com/v4beta/geocode/address
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter |
locationBias |
object (GeocodeAddressRequest.LocationBias )
Optional. Die Region, in der gesucht werden soll. Dieser Standort dient als Bias. Das bedeutet, dass Ergebnisse in der Nähe des angegebenen Standorts zurückgegeben werden können.
|
languageCode |
string
Optional. Sprache, in der die Ergebnisse zurückgegeben werden sollen.
|
regionCode |
string
Optional. Regionscode. Der Regionscode, angegeben als zweistelliger Ländercode der Top-Level-Domain (ccTLD). Der Parameter wirkt sich auf Ergebnisse aus, die auf anwendbarem Recht basieren. Durch diesen Parameter werden die Ergebnisse des Dienstes zwar beeinflusst, aber nicht vollständig eingeschränkt.
|
Union-Parameter address_input . Die Adresse, die geocodiert werden soll. Für address_input ist nur einer der folgenden Werte zulässig: |
addressQuery |
string
Die unstrukturierte Adresse, die geocodiert werden soll.
|
address |
object (PostalAddress )
Die strukturierte Adresse, die im Format einer Postanschrift geocodiert werden soll.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von GeocodeAddressResponse
.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/maps-platform.geocode
https://www.googleapis.com/auth/maps-platform.geocode.address
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-31 (UTC)."],[],[],null,["# Method: geocode.address.geocodeAddress\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nThis method performs an address geocode, which maps an address to a LatLng. It also provides structured information about the address.\n\n### HTTP request\n\n`GET https://geocode.googleapis.com/v4beta/geocode/address`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `locationBias` | `object (`[GeocodeAddressRequest.LocationBias](/maps/documentation/geocoding/reference/rest/v4beta/GeocodeAddressRequest.LocationBias)`)` Optional. The region to search. This location serves as a bias which means results around given location might be returned. |\n| `languageCode` | `string` Optional. Language in which the results should be returned. |\n| `regionCode` | `string` Optional. Region code. The region code, specified as a ccTLD (\"top-level domain\") two-character value. The parameter affects results based on applicable law. This parameter will also influence, but not fully restrict, results from the service. |\n| Union parameter `address_input`. The address to geocode. `address_input` can be only one of the following: ||\n| `addressQuery` | `string` The unstructured address to geocode. |\n| `address` | `object (`[PostalAddress](/maps/documentation/geocoding/reference/rest/Shared.Types/PostalAddress)`)` The structured address to geocode in postal address format. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [GeocodeAddressResponse](/maps/documentation/geocoding/reference/rest/v4beta/GeocodeAddressResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/maps-platform.geocode`\n- `\n https://www.googleapis.com/auth/maps-platform.geocode.address`"]]