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 destinos 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
  • https://www.googleapis.com/auth/maps-platform.destinations

GeocodeService

Es un servicio para realizar 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 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

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 el 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 subdestinos 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 destinos secundarios es más exhaustiva, y cada destino secundario contiene más información.
landmarks[]

Landmark

Son puntos de referencia que se pueden usar para comunicar dónde se encuentra el destino o ayudar con la llegada.
entrances[]

Entrance

Son las entradas de este destino.
navigation_points[]

NavigationPoint

Son los puntos de navegación de este destino.
parking_options

Destination.ParkingOptions

Son las opciones de estacionamiento para este destino.
arrival_summary

Destination.ArrivalSummary

Resumen generado por IA de la experiencia de llegada al destino.

ArrivalSummary

Resumen generado por IA de la experiencia de llegada al destino.

Campos
text

LocalizedText

Es el resumen de la experiencia de llegada al destino.
flag_content_url

string

Un vínculo en el que los usuarios pueden marcar un problema con el resumen
disclosure_text

LocalizedText

Solo salida. Contiene el texto de divulgación del resumen de llegada.

ParkingOptions

Información sobre las opciones de estacionamiento para el destino.

Campos
availability

Destination.ParkingOptions.Availability

La disponibilidad de estacionamiento para este destino.
parking_facilities[]

Destination.ParkingOptions.ParkingFacility

Las instalaciones de estacionamiento de este destino.
onsite_parking

bool

Hay estacionamiento en el destino.
free_parking_lot

bool

Ofrece estacionamiento gratuito.
paid_parking_lot

bool

Ofrece estacionamientos pagados.
free_street_parking

bool

Ofrece estacionamiento gratuito en la calle.
paid_street_parking

bool

Ofrece estacionamiento pagado en la calle.
valet_parking

bool

Ofrece servicio de estacionamiento.
free_garage_parking

bool

Ofrece estacionamiento gratuito en cochera.
paid_garage_parking

bool

Ofrece estacionamiento en cochera de pago.

Disponibilidad

Es una medición agregada de la dificultad para encontrar estacionamiento cuando se visita este lugar.

Es posible que se agreguen valores nuevos en el futuro.

Enums
AVAILABILITY_UNSPECIFIED La disponibilidad de estacionamiento no está disponible.
PLENTY Hay mucho espacio de estacionamiento disponible.
SOMEWHAT_DIFFICULT Es un poco difícil encontrar estacionamiento.
DIFFICULT Es muy difícil encontrar estacionamiento.

ParkingFacility

Es una opción de estacionamiento individual y discreta (p.ej., un estacionamiento o un lote específicos) asociada con el destino. Este mensaje proporciona información detallada sobre un estacionamiento específico, mientras que el mensaje ParkingOptions superior proporciona un resumen de todos los estacionamientos disponibles.

Campos
place

PlaceView

Es la representación del lugar de este estacionamiento específico.
onsite

bool

Indica si este estacionamiento se encuentra en las instalaciones del destino principal. Si no se configura este campo, se desconoce el estado en las instalaciones.
popular

bool

Indica si este estacionamiento es una opción popular para los visitantes que viajan al destino principal. Si no se establece este campo, se desconoce el estado de popularidad.
straight_line_distance_meters

double

Es la distancia en línea recta en metros desde el destino principal hasta este estacionamiento.

Entrada

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

Campos
display_name

LocalizedText

Nombre legible por humanos, p.ej., "Puerta B", "Entrada sur", "Entrada de la 5ª avenida".
location

LatLng

La 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}.
street_view_thumbnail

StreetViewThumbnail

Imagen en miniatura de Street View que muestra la entrada. La imagen se puede solicitar a la API de Street View Static. Consulta https://developers.google.com/maps/documentation/streetview/request-streetview.
street_view_annotation

ImageAnnotation

Anotación de la entrada en el street_view_thumbnail que se devolvió anteriormente.

Etiqueta

Características que describen una entrada.

Enums
TAG_UNSPECIFIED No se usa.
PREFERRED

Es probable que la entrada proporcione acceso físico al lugar principal en el destino que se muestra. Un lugar puede tener varias entradas preferidas. Si una entrada no tiene esta etiqueta, significa que se encuentra 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 lleven al restaurante, mientras que las otras entradas devueltas serán otras entradas del 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 acceder al área del vestíbulo principal, pero si una entrada solo permite acceder a una tienda en el lateral del edificio, no será una entrada PREFERRED.

Nota: Es posible que una entrada PREFERRED no proporcione acceso al lugar principal y que una entrada que no sea PREFERRED sí lo haga.

GeocodeAddressRequest

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 prefieren los resultados alrededor de la ubicación proporcionada.
language_code

string

Opcional. Es el idioma en el que se deben mostrar los resultados.
region_code

string

Opcional. Es el código de la región. Es el código de región, especificado como un valor ccTLD ("dominio de nivel superior") de dos caracteres. 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 address_input. Es la dirección que se geocodificará. address_input puede ser solo uno de los parámetros siguientes:
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 prefieren los resultados alrededor de la ubicación proporcionada.

Campos
Campo de unión type. Tipos de sesgo de ubicación. type puede ser solo uno de los parámetros siguientes:
rectangle

Viewport

Es un cuadro rectangular definido por las esquinas noreste y suroeste. rectangle.high() debe ser el punto noreste del viewport del rectángulo. rectangle.low() debe ser el punto sudoeste del rectángulo de la ventana de visualización. rectangle.low().latitude() no puede ser mayor que rectangle.high().latitude(). Esto dará como resultado un rango de latitud vacío. Un viewport rectangular no puede tener más de 180 grados de ancho.

GeocodeAddressResponse

Mensaje de respuesta para GeocodeService.GeocodeAddress.

Campos
results[]

GeocodeResult

Es el resultado de la geocodificación.

GeocodeLocationRequest

Mensaje de solicitud para GeocodeService.GeocodeLocation.

Campos
language_code

string

Opcional. Es el idioma en el que se deben mostrar los resultados.
region_code

string

Opcional. Es el código de la región. Es el código de región, especificado como un valor ccTLD ("dominio de nivel superior") de dos caracteres. 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 los 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 enumeraciones de nivel de detalle de la ubicación.
Campo de unión location_input. Es la ubicación que se geocodificará. location_input puede ser solo uno de los parámetros siguientes:
location_query

string

Es la ubicación en el formato de cadena "lat,lng". Por ejemplo, "64.7611872,-18.4705364".
location

LatLng

Es la ubicación en el formato estructurado.

GeocodeLocationResponse

Mensaje de respuesta para GeocodeService.GeocodeLocation.

Campos
results[]

GeocodeResult

Es el resultado de la geocodificación.
plus_code

PlusCode

Es el Plus Code de la ubicación en la solicitud.

GeocodePlaceRequest

Mensaje de solicitud para GeocodeService.GeocodePlace.

Campos
place

string

Obligatorio. Es el identificador de lugar que se geocodificará en el formato places/{place}.
language_code

string

Opcional. Es el idioma en el que se deben mostrar los resultados.
region_code

string

Opcional. Es el código de la región. Es el código de región, especificado como un valor ccTLD ("dominio de nivel superior") de dos caracteres. 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 nombre del recurso de este lugar, en formato places/{placeId}. Se puede usar para buscar el lugar.
place_id

string

Es el identificador único de un lugar.
location

LatLng

La latitud y longitud 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 de la geocodificación.
bounds

Viewport

Es un cuadro delimitador para la dirección.
formatted_address

string

La dirección con formato de una línea.
postal_address

PostalAddress

Es la dirección en formato de dirección postal.
address_components[]

GeocodeResult.AddressComponent

Componentes repetidos para cada nivel de localidad.
postal_code_localities[]

LocalizedText

Es la lista completa de 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 los 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 este geocódigo.

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 el nombre largo "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 Australia puede tener el nombre corto "AU".
types[]

string

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

Estos valores se extraen de la tabla de tipos de direcciones y tipos de componentes de dirección que usa la API de Places: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code

string

Es el idioma que se usa para dar formato a este componente, en notación CLDR.

Nivel de detalle

Es el nivel de detalle de la ubicación.

Enums
GRANULARITY_UNSPECIFIED No lo utilices.
ROOFTOP Es la ubicación no interpolada de una parcela de terreno real que corresponde a la dirección coincidente.
RANGE_INTERPOLATED Se interpoló a partir de un rango de números de calle. 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.

ImageAnnotation

Es una anotación en una miniatura de imagen, como un polígono que delimita una entrada.

Campos
coordinates[]

ImageAnnotation.Coordinate

Es una lista de coordenadas que forman un polígono en la imagen. Las coordenadas se ordenan en el sentido contrario a las manecillas del reloj.

Coordenada

Coordenada de píxel de un punto de la imagen. El origen (0,0) es la esquina superior izquierda del píxel superior izquierdo de la imagen, con el eje X apuntando hacia la derecha y el eje Y apuntando hacia abajo.

Campos
x_px

float

Coordenada de X.
y_px

float

Coordenada de Y.

Punto de referencia

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

Campos
relational_description

LocalizedText

Es una descripción legible por humanos de cómo se relaciona el destino con el punto de referencia. Por ejemplo: "Cerca del edificio Empire State" o "Frente a la Casa Blanca".
tags[]

Landmark.Tag

Son etiquetas que describen cómo se puede usar el punto de referencia en el contexto del destino.
straight_line_distance_meters

double

Solo salida. Es la distancia en línea recta desde este punto de referencia hasta el destino, en metros.
travel_distance_meters

double

Solo salida. Es la distancia a pie desde este punto de referencia hasta el destino, en metros.
Campo de unión landmark. Es el punto de referencia. landmark puede ser solo uno de los parámetros siguientes:
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.

Enums
TAG_UNSPECIFIED No se usa.
ADDRESS 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 de descriptores de direcciones 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 una vez que estás cerca del destino. Por ejemplo, este punto de referencia podría ser un lugar que se encuentra cruzando la calle desde el destino. Un punto de referencia con esta etiqueta suele estar 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
navigation_point_token

string

Solo salida. Es un token que se puede usar para identificar este punto de navegación.
display_name

LocalizedText

Es el nombre visible de este punto de navegación. Por ejemplo, "5ª avenida" o "Puerta B".
location

LatLng

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

NavigationPoint.TravelMode

Son los medios de transporte adecuados para este punto de navegación.
usages[]

NavigationPoint.Usage

Enumera los usages admitidos por este punto de navegación. Si está vacío, no significa necesariamente que su uso esté restringido de alguna manera. Todos los puntos de navegación se pueden usar para la navegación general.
street_view_thumbnail

StreetViewThumbnail

Es la imagen en miniatura de Street View que muestra el punto de navegación, si está disponible. La imagen se puede solicitar a la API de Street View Static. Consulta https://developers.google.com/maps/documentation/streetview/request-streetview.
entrance_annotation

ImageAnnotation

Anotación de la entrada asociada con este punto de navegación en el street_view_thumbnail que se devolvió anteriormente, si está disponible.
altitude_meters

float

Es la altitud del punto de navegación en metros en relación con el elipsoide WGS-84.

TravelMode

Son los medios de transporte adecuados para este punto de navegación.

Enums
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. Es posible que se agreguen valores nuevos en el futuro.

Enums
USAGE_UNSPECIFIED No se usa.
UNKNOWN Indica que se desconoce el tipo de uso.
DROPOFF Es adecuado para dejar a un pasajero. Por ejemplo, una ubicación de llegada de un viaje compartido.
PICKUP Adecuado para recoger a un pasajero. Por ejemplo, un punto de partida de un viaje compartido.
PARKING Adecuado para estacionar. Por ejemplo, dentro de un estacionamiento.

PlaceView

Representa una vista de un lugar en la API de Places. También proporciona información adicional específica de 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

Es el nombre del recurso de este lugar, en formato places/{placeId}. Se puede usar para buscar el lugar.
place_id

string

Es el identificador único de un lugar.
display_name

LocalizedText

Es una descripción del lugar legible por humanos. 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 completa. Prepárate para usar el campo types en esas situaciones.
types[]

string

Todos los tipos de lugares asociados con 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 línea.
postal_address

PostalAddress

Dirección estructurada.
structure_type

PlaceView.StructureType

Es el tipo de estructura que corresponde 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 punto para colocar un marcador en el mapa.
display_polygon

Struct

Es el contorno del polígono 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.
address_components[]

PlaceView.AddressComponent

Componentes repetidos para cada nivel de localidad.

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 el nombre largo "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 Australia puede tener el nombre corto "AU".
types[]

string

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

Estos valores se extraen de la tabla de tipos de direcciones y tipos de componentes de dirección que usa la API de Places: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code

string

Es el idioma que se usa para dar formato a este componente, en notación CLDR.

StructureType

Es el tipo de estructura que representa este lugar.

Enums
STRUCTURE_TYPE_UNSPECIFIED No se usa.
POINT 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.

PlusCode

El Plus Code (http://plus.codes) es una referencia de ubicación con dos formatos: el 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 el 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, Noruega", que contiene el sufijo del código global y reemplaza el prefijo por un nombre con formato de una entidad de referencia.

SearchDestinationsRequest

Es el mensaje de solicitud para DestinationService.SearchDestinations.

Campos
travel_modes[]

NavigationPoint.TravelMode

Opcional. Son los modos 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 devuelven los puntos de navegación de todos los medios de transporte.
language_code

string

Opcional. Es el idioma en el que se deben mostrar los resultados.
region_code

string

Opcional. Es el código de la región. Es el código de región, especificado como un valor ccTLD ("dominio de nivel superior") de dos caracteres. El parámetro afecta los resultados según la legislación aplicable. Este parámetro también influye en los resultados del servicio, pero no los restringe por completo.

Campo de unión primary_query. Consulta 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 crean en torno a la consulta principal especificada.

Nota: Solo se admiten lugares y direcciones que puedan tener un destino de navegación. Por ejemplo, un lugar que representa una casa o un complejo de departamentos se puede usar como consulta principal, pero los lugares que representan una localidad o un área administrativa no se pueden usar como consulta 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 que quieres 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. kind puede ser solo uno de los parámetros siguientes:
address

PostalAddress

Es una dirección en formato de dirección postal.
address_query

string

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

LocationQuery

Una consulta de ubicación para identificar un destino principal cercano.

Nota: Si la consulta de ubicación se encuentra dentro de un edificio que contiene sublocales, es posible que el lugar principal que se devuelva sea un sublocal. En estos casos, el campo containing_places incluirá el edificio.

Campos
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

Opcional. Son los filtros que se aplicarán a los candidatos de destino.
Campo de unión kind. Es la consulta de ubicación. kind puede ser solo uno de los parámetros siguientes:
location

LatLng

Una ubicación precisa de LatLng.

PlaceFilter

Son los filtros que se aplicarán a los candidatos de destino.

Campos
structure_type

PlaceView.StructureType

Opcional. Si se especifica, se garantiza que todos los destinos tengan un lugar principal con este tipo de estructura. Esto puede provocar que se filtren algunos destinos o que se amplíen o acoten los destinos que se devuelven.

Por ejemplo, si se especifica GROUNDS, todos los destinos devueltos tendrán un lugar principal con el tipo de estructura GROUNDS. Esto puede provocar que se filtren algunos destinos que no forman parte de un recinto o que se simplifiquen los destinos devueltos al nivel del recinto.

Otro uso de este campo es extraer con mayor facilidad los polígonos de visualización de edificios. Por ejemplo, si se especifica BUILDING, el polígono de visualización del lugar principal será el del edificio en la ubicación especificada.
addressability

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

Opcional. Si se especifica, solo se devuelven los destinos que cumplen con los criterios de direccionabilidad correspondientes.

Capacidad de alcance

Define las opciones para el filtrado de direccionabilidad. Es posible que se agreguen valores nuevos en el futuro.

Enums
ADDRESSABILITY_UNSPECIFIED Cuando no se especifica, el servicio elegirá un valor predeterminado razonable.
ANY La direccionabilidad no es un criterio de filtrado. Los destinos se devuelven independientemente de su direccionabilidad.
PRIMARY Todos los destinos que se devuelvan tendrán un lugar principal con una dirección o un nombre a nivel de la calle.
WEAK Todos los destinos que se devuelvan tendrán un lugar principal o un subdestino con una dirección o un nombre a nivel de la calle.

SearchDestinationsResponse

Mensaje de respuesta para DestinationService.SearchDestinations.

Campos
destinations[]

Destination

Una lista de destinos.

El servicio devuelve un resultado si se puede identificar un destino principal de forma inequívoca a partir de la consulta principal. De lo contrario, el servicio podría devolver varios resultados para eliminar la ambigüedad o ningún resultado.

StreetViewThumbnail

Son los parámetros para representar una miniatura de Google Street View. Estos parámetros se pueden usar para solicitar una imagen de Street View a la API de Street View Static. Consulta https://developers.google.com/maps/documentation/streetview/request-streetview.

Campos
pano

string

Un ID de panorámica específico
width_px

int32

Es el ancho de la imagen de la miniatura de salida en píxeles. Nota: Cuando solicites anotaciones junto con la miniatura, estos valores de altura y ancho se deben usar en la solicitud a la API de Street View para garantizar que las coordenadas de la anotación se alineen correctamente con la imagen.
height_px

int32

Es la altura de la imagen de la miniatura de salida en píxeles. Nota: Cuando solicites anotaciones junto con la miniatura, estos valores de altura y ancho se deben usar en la solicitud a la API de Street View para garantizar que las coordenadas de la anotación se alineen correctamente con la imagen.
heading_degree

float

Es la orientación horizontal de la cámara en grados. Rango [0, 360). El 0 indica el norte y el 90, el este.
pitch_degree

float

Es la orientación vertical de la cámara en grados. Rango [-90, 90]. 0 es el horizonte, +90 es hacia arriba y -90 es hacia abajo.
fov_degree

float

Es el campo visual horizontal en grados. Rango (0, 180]. Controla el nivel de zoom. Un FOV más pequeño significa más zoom.