Package google.maps.geocode.v4beta

Índice

GeocodeService

Es un servicio para realizar la geocodificación.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

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.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address
GeocodeLocation

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

Este método realiza una geocodificación de ubicación, que asigna un LatLng a una dirección. También proporciona información estructurada sobre la dirección.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location
GeocodePlace

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

Este método realiza una búsqueda de geocodificación con un ID de lugar.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.place

GeocodeAddressRequest

Es el mensaje de solicitud para GeocodeService.GeocodeAddress.

Campos
location_bias

GeocodeAddressRequest.LocationBias

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.

language_code

string

Opcional. Idioma en el que se deben mostrar los resultados.

region_code

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.

Campo de unión address_input. Es la dirección que se geocodificará. Las direcciones (address_input) solo pueden ser una de las siguientes opciones:
address_query

string

Es la dirección no estructurada que se geocodificará.

address

PostalAddress

Es la dirección estructurada que se geocodificará en formato de dirección postal.

LocationBias

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.

Campos
Campo de unión type. Tipos de sesgo de ubicación. Las direcciones (type) solo pueden ser una de las siguientes opciones:
rectangle

Viewport

Es un cuadro rectangular definido por las esquinas noreste y suroeste. rectangle.high() debe ser el punto noreste de la ventana gráfica rectangular. rectangle.low() debe ser el punto suroeste de la ventana gráfica rectangular. rectangle.low().latitude() no puede ser mayor que rectangle.high().latitude(). Esto generará un rango de latitud vacío. Un viewport rectangular no puede tener un ancho superior a 180 grados.

GeocodeAddressResponse

Mensaje de respuesta para GeocodeService.GeocodeAddress.

Campos
results[]

GeocodeResult

Es el resultado de la geocodificación.

GeocodeLocationRequest

Es el mensaje de solicitud para GeocodeService.GeocodeLocation.

Campos
language_code

string

Opcional. Idioma en el que se deben mostrar los resultados.

region_code

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.

types[]

string

Opcional. Es un conjunto de etiquetas de tipo para restringir los resultados. Se quitan los resultados que no tienen ninguno de los tipos especificados.

Para obtener la lista completa de valores posibles, consulta la Tabla A y la Tabla B en https://developers.google.com/maps/documentation/places/web-service/place-types.

granularity[]

GeocodeResult.Granularity

Opcional. Es un filtro de uno o más valores de enumeración de granularidad de la ubicación.

Campo de unión location_input. Es la ubicación que se geocodificará. Las direcciones (location_input) solo pueden ser una de las siguientes opciones:
location_query

string

Ubicación en formato de cadena "lat,lng". Por ejemplo, “64.7611872,-18.4705364”.

location

LatLng

Es la ubicación en formato estructurado.

GeocodeLocationResponse

Mensaje de respuesta para GeocodeService.GeocodeLocation.

Campos
results[]

GeocodeResult

Es el resultado de la geocodificación.

plus_code

PlusCode

Es el código plus de la ubicación en la solicitud.

GeocodePlaceRequest

Es el mensaje de solicitud para GeocodeService.GeocodePlace.

Campos
place

string

Es obligatorio. Es el identificador de lugar para geocodificar en el formato places/{place}.

language_code

string

Opcional. Idioma en el que se deben mostrar los resultados.

region_code

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.

GeocodeResult

Un resultado de geocodificación contiene información geográfica sobre un lugar.

Campos
place

string

Es el identificador de lugar completamente calificado para este resultado. Tiene el formato "//places.googleapis.com/places/{placeID}". Consulta https://developers.google.com/maps/documentation/places/web-service/place-id para obtener más detalles.

place_id

string

Es el ID de lugar de este resultado.

location

LatLng

Es la LatLng de esta dirección.

granularity

GeocodeResult.Granularity

Es el nivel de detalle de la ubicación.

viewport

Viewport

Es un viewport adecuado para mostrar el resultado del geocódigo.

bounds

Viewport

Es un cuadro de límite para la dirección.

formatted_address

string

Es la dirección con formato de una sola línea.

postal_address

PostalAddress

Es la dirección en formato de dirección postal.

address_components[]

GeocodeResult.AddressComponent

Son componentes repetidos para cada nivel de localidad.

postal_code_localities[]

LocalizedText

Es la lista completa de las localidades incluidas en el código postal.

Este campo solo se propaga cuando el resultado es del tipo "postal_code".

types[]

string

Es un conjunto de etiquetas de tipo para este resultado. Por ejemplo, "political" y "administrative_area".

Para obtener la lista completa de valores posibles, consulta la Tabla A y la Tabla B en https://developers.google.com/maps/documentation/places/web-service/place-types.

plus_code

PlusCode

Es el Plus Code de la ubicación en esta geocodificación.

AddressComponent

Son los componentes estructurados que forman la dirección con formato, si esta información está disponible.

Campos
long_text

string

Es la descripción textual completa o el nombre del componente de la dirección. Por ejemplo, un componente de dirección para el país Australia puede tener un nombre largo de "Australia".

short_text

string

Es un nombre textual abreviado para el componente de la dirección, si está disponible. Por ejemplo, un componente de dirección para el país de Australia puede tener el nombre corto "AU".

types[]

string

Es un array que indica los tipos de componente de dirección.

Consulta https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types para obtener más detalles.

language_code

string

Es el idioma que se usa para dar formato a estos componentes, en notación de CLDR.

Nivel de detalle

Es el nivel de detalle de la ubicación.

Enumeraciones
GRANULARITY_UNSPECIFIED No lo utilices.
ROOFTOP Es la ubicación no interpolada de una parcela real que corresponde a la dirección coincidente.
RANGE_INTERPOLATED Se interpola a partir de un rango de números de calles. Por ejemplo, si sabemos que un tramo de Amphitheatre Pkwy contiene los números del 1600 al 1699, el 1650 podría ubicarse a mitad de camino entre sus extremos.
GEOMETRIC_CENTER Es el centro geométrico de un componente para el que tenemos datos poligonales.
APPROXIMATE Todo lo demás.

PlusCode

El Plus Code (http://plus.codes) es una referencia de ubicación con dos formatos: código global que define un rectángulo de 14 m x 14 m (1/8,000 de un grado) o más pequeño, y código compuesto, que reemplaza el prefijo por una ubicación de referencia.

Campos
global_code

string

Es el código global (completo) del lugar, como "9FWM33GV+HQ", que representa un área de 1/8,000 por 1/8,000 de grado (aproximadamente 14 por 14 metros).

compound_code

string

Es el código compuesto del lugar, como "33GV+HQ, Ramberg, Norway", que contiene el sufijo del código global y reemplaza el prefijo por el nombre con formato de una entidad de referencia.