Este método realiza una geocodificación de dirección, que asigna una dirección a un objeto LatLng. También proporciona información estructurada sobre la dirección.
Solicitud HTTP
GET https://geocode.googleapis.com/v4beta/geocode/address/{addressQuery}
Parámetro de unión address_input. Es la dirección que se geocodificará. Las direcciones (address_input) solo pueden ser una de las siguientes opciones:
addressQuery
string
Es la dirección no estructurada que se geocodificará.
Opcional. Es la región en la que se realizará la búsqueda. Esta ubicación sirve como sesgo, lo que significa que se pueden mostrar resultados alrededor de la ubicación proporcionada.
languageCode
string
Opcional. Idioma en el que se deben mostrar los resultados.
regionCode
string
Opcional. Es el código de región. Es el código de región, especificado como un valor de dos caracteres del ccTLD ("dominio de nivel superior"). El parámetro afecta los resultados según la legislación aplicable. Este parámetro también afectará los resultados del servicio, pero no los restringirá por completo.
Parámetro de unión address_input. Es la dirección que se geocodificará. Las direcciones (address_input) solo pueden ser una de las siguientes opciones:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-31 (UTC)"],[],[],null,["# Method: geocode.address.geocodeAddressQuery\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\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/{addressQuery}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------|\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\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| `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`"]]
