Package google.maps.geocode.v4alpha

Índice

DestinationService

Es un servicio para recuperar destinos.

Un destino proporciona contexto jerárquico sobre un lugar, lo que te permite, por ejemplo, encontrar edificios de departamentos dentro de un complejo de departamentos más grande y viceversa. También proporciona puntos de navegación adecuados para casos de uso como viajes compartidos o entregas.

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

Este método realiza una búsqueda de destino y devuelve una lista de destinos.

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

Destino

Un destino Esto incluye el lugar principal, los lugares relacionados, las entradas y los puntos de navegación.

Campos
primary

PlaceView

Es el lugar principal que identifica primary_query en la solicitud.
containing_places[]

PlaceView

Son los lugares menos precisos que contienen el lugar principal. Por ejemplo, el complejo de departamentos que contiene este edificio.
sub_destinations[]

PlaceView

Son destinos secundarios más precisos del lugar principal. Por ejemplo, las unidades que contiene un edificio.

Nota: En comparación con el objeto SubDestination que devuelve la API de Places, esta lista de subdestinos es más exhaustiva y cada subdestino contiene más información.
landmarks[]

Landmark

Puntos de referencia que se pueden usar para comunicar dónde está el destino o ayudar con la llegada.
entrances[]

Entrance

Son las entradas para este destino.
navigation_points[]

NavigationPoint

Son los puntos de navegación para este destino.

Entrada

Una entrada es un solo par de coordenadas de latitud y longitud que define la ubicación de un punto de entrada y salida de un lugar.

Campos
location

LatLng

Ubicación de la entrada.
tags[]

Entrance.Tag

Es una lista de etiquetas que describen la entrada.
place

string

Es la estructura en la que se encuentra físicamente esta entrada, en formato places/{place_id}.

Etiqueta

Son las características que describen una entrada.

Enumeraciones
TAG_UNSPECIFIED No se usa.
PREFERRED

Es probable que la entrada proporcione acceso físico al lugar principal del destino devuelto. Un lugar puede tener varias entradas preferidas. Si una entrada no tiene esta etiqueta, significa que está físicamente en el mismo edificio que el lugar principal, pero no necesariamente proporciona acceso a él.

Por ejemplo, si el lugar principal es un restaurante en un centro comercial, las entradas "PREFERRED" serán las que probablemente conduzcan al restaurante, mientras que las otras entradas que se devuelvan serán otras entradas al edificio, como las entradas a otros restaurantes del centro comercial.

Si el lugar principal es un edificio, las entradas PREFERRED serán las que conducen a la parte "principal" del edificio. Por ejemplo, en un centro comercial, las entradas PREFERRED serán las que permitan el acceso al área principal del vestíbulo, pero si una entrada solo proporciona acceso a una tienda en el costado del edificio, no será una entrada PREFERRED.

Nota: Una entrada PREFERRED podría no proporcionar acceso al lugar principal, y una entrada que no sea PREFERRED podría proporcionar acceso al lugar principal.

Punto de referencia

Los puntos de referencia se usan para comunicar dónde está el destino o ayudar a llegar a él.

Campos
tags[]

Landmark.Tag

Son etiquetas que describen cómo se puede usar el punto de referencia en el contexto del destino.
Campo de unión landmark. Es el punto de referencia. Las direcciones (landmark) solo pueden ser una de las siguientes opciones:
place

PlaceView

Es el lugar que representa este punto de referencia.

Etiqueta

Es la lista de todas las etiquetas posibles que describen cómo se puede usar un punto de referencia en el contexto de un destino.

Si una dirección tiene las etiquetas ADDRESS y ARRIVAL, significa que el punto de referencia es destacado a nivel local y está cerca del destino.

Enumeraciones
TAG_UNSPECIFIED No se usa.
ADDRESS Es un lugar destacado a nivel local que se puede usar para identificar la ubicación general del destino. Por lo general, a unos cientos de metros del destino. Son similares a los puntos de referencia que devuelve la función Address Descriptors de la API de Geocoding: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL Es un lugar que se puede usar para ayudar a llegar al destino. Es útil para la navegación cuando estás cerca del destino. Por ejemplo, este punto de referencia podría ser un lugar que se encuentra frente al destino. Por lo general, un punto de referencia con esta etiqueta está más cerca del destino que los puntos de referencia con la etiqueta ADDRESS.

Un punto de navegación es una ubicación junto a una ruta donde puede finalizar la navegación.

Campos
display_name

LocalizedText

Es el nombre visible de este punto de navegación. Por ejemplo, "5th Ave" o "Gate B".
location

LatLng

Es un punto junto al tramo de ruta en el que debería finalizar la navegación. El punto se desplaza intencionalmente un poco del centro de la ruta para marcar claramente el lado de la ruta en el que se encuentra el lugar.
travel_modes[]

NavigationPoint.TravelMode

Son los modos de viaje adecuados para este punto de navegación.
usages[]

NavigationPoint.Usage

Son los usos que admite este punto de navegación.

TravelMode

Son los modos de viaje adecuados para este punto de navegación.

Enumeraciones
TRAVEL_MODE_UNSPECIFIED No se usa.
DRIVE Apto para conducir
WALK Apto para caminar

Uso

Son los usos que admite este punto de navegación.

Enumeraciones
USAGE_UNSPECIFIED No se usa.
UNKNOWN Tipo de uso desconocido. La mayoría de los puntos de navegación serán UNKNOWN, y esto no significa necesariamente que su uso esté restringido de alguna manera. Es posible que esta navegación siga siendo adecuada para la recogida o la entrega.
DROPOFF Es apto para dejar a un pasajero. Por ejemplo, la ubicación de destino de un viaje compartido.
PICKUP Es adecuado para recoger a un pasajero. Por ejemplo, la ubicación de partida de un viaje compartido.

PlaceView

Representa una vista de un lugar en la API de Places. También proporciona información adicional específica para los destinos, como el tipo de estructura y el polígono de visualización.

En algunos casos, un PlaceView con el mismo ID de lugar puede diferir de lo que devuelve la API de Places para los campos types y display_name.

Campos
place

string

Nombre del recurso de este lugar, en formato places/{placeId}.
display_name

LocalizedText

Es una descripción legible del lugar. Por ejemplo, “Puerta B”, “McDonalds”
primary_type

string

Es el tipo de lugar principal de este lugar. Consulta https://developers.google.com/maps/documentation/places/web-service/place-types para ver la lista de valores posibles.

Nota: Este campo no siempre se propaga. Prepárate para usar el campo types en esas situaciones.
types[]

string

Son todos los tipos de lugares asociados a este lugar. Consulta https://developers.google.com/maps/documentation/places/web-service/place-types para ver la lista de valores posibles.
formatted_address

string

Dirección de una sola línea.
postal_address

PostalAddress

Dirección estructurada.
structure_type

PlaceView.StructureType

Es el tipo de estructura correspondiente a este lugar.
location

LatLng

Es la ubicación de este lugar. En el caso de los lugares con polígonos de visualización, esto puede representar un buen lugar para colocar un marcador en el mapa.
display_polygon

Struct

Es el contorno poligonal del lugar en formato GeoJSON, con el formato RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

Nota: El formato RFC 7946 admite MultiPolygons, por lo que un objeto display_polygon puede representar varios polígonos.

StructureType

Es el tipo de estructura que representa este lugar.

Enumeraciones
STRUCTURE_TYPE_UNSPECIFIED No se usa.
POINT Es una ubicación de punto.
SECTION Es una subsección de un edificio.
BUILDING Un edificio.
GROUNDS Es un área grande que suele contener varios edificios, como un campus universitario, un complejo de departamentos o un centro comercial.

SearchDestinationsRequest

Es el mensaje de solicitud para DestinationService.SearchDestinations.

Campos
travel_modes[]

NavigationPoint.TravelMode

Opcional. Son los medios de transporte para los que se filtrarán los puntos de navegación. Esto influye en el campo navigation_points que se devuelve en la respuesta. Si está vacío, se pueden devolver los puntos de navegación de todos los medios de transporte.
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 afecta los resultados del servicio, pero no los restringe por completo.

Campo de unión primary_query. Consulta para el destino principal. Puede ser un lugar, una dirección completamente especificada o una ubicación de LatLng. Algunos lugares y direcciones con información mínima no se podrán convertir en destinos.

Los destinos se compilan en torno a la búsqueda principal especificada.

Nota: Solo se admiten los lugares y las direcciones que pueden tener un destino de navegación. Por ejemplo, un lugar que representa una casa o un complejo de apartamentos se puede usar como la búsqueda principal, pero los lugares que representan una localidad o un área administrativa no se pueden usar como la búsqueda principal. primary_query puede ser una de las siguientes opciones:
place

string

Es el nombre del recurso de un lugar, en formato places/{place_id}.
address_query

SearchDestinationsRequest.AddressQuery

Una dirección.
location_query

SearchDestinationsRequest.LocationQuery

Una ubicación precisa

AddressQuery

Es la dirección de la calle que deseas buscar. Especifica una dirección conforme al formato usado por el servicio postal nacional del país en cuestión.

Campos
Campo de unión kind. Es la consulta de dirección. Las direcciones (kind) solo pueden ser una de las siguientes opciones:
address

PostalAddress

Una dirección en formato de dirección postal.
address_query

string

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

LocationQuery

Es una búsqueda de ubicación para identificar un destino principal cercano.

Nota: Si la búsqueda de ubicación se realiza dentro de un edificio que contiene subinstalaciones, es posible que el lugar principal que se devuelva sea una subinstalación. En estos casos, el campo containing_places incluirá el edificio.

Campos
Campo de unión kind. Es la búsqueda de ubicación. Las direcciones (kind) solo pueden ser una de las siguientes opciones:
location

LatLng

Es una ubicación LatLng precisa.

SearchDestinationsResponse

Es el mensaje de respuesta para DestinationService.SearchDestinations.

Campos
destinations[]

Destination

Es una lista de destinos.

El servicio devuelve un resultado si se puede identificar de forma inequívoca un destino principal a partir de la búsqueda principal. De lo contrario, es posible que el servicio muestre varios resultados para la desambiguación o ningún resultado.