Package google.maps.places.v1

Índice

Places

Definición del servicio para la API de Places. Nota: Todas las solicitudes (excepto las solicitudes a Autocomplete) requieren una máscara de campo configurada fuera del archivo proto de la solicitud (no se supone que es all/*). La máscara de campo se puede configurar a través del encabezado HTTP X-Goog-FieldMask. Consulta: https://developers.google.com/maps/documentation/places/web-service/choose-fields

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

Muestra predicciones para la entrada dada.

GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

Obtén un contenido multimedia fotográfico con una cadena de referencia de foto.

GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

Obtén los detalles de un lugar según su nombre de recurso, que es una cadena en formato places/{place_id}.

SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

Busca lugares cerca de ubicaciones.

SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

Búsqueda de lugares basada en búsquedas de texto.

AuthorAttribution

Información sobre el autor de los datos de CGU. Se usa en Photo y Review.

Campos
display_name

string

Es el nombre del autor de Photo o Review.

uri

string

El URI del autor de Photo o Review.

photo_uri

string

El URI de la foto de perfil del autor de Photo o Review.

AutocompletePlacesRequest

Solicita un archivo .proto para AutocompletePlaces.

Campos
input

string

Obligatorio. Cadena de texto en la que se realiza la búsqueda

location_bias

LocationBias

Opcional. Personaliza los resultados según una ubicación específica.

Se debe establecer uno de location_bias o location_restriction como máximo. Si no se establece ninguna, los resultados se personalizarán por la dirección IP, lo que significa que la dirección IP se asignará a una ubicación imprecisa y se utilizará como señal de personalización.

location_restriction

LocationRestriction

Opcional. Restringe los resultados a una ubicación específica.

Se debe establecer uno de location_bias o location_restriction como máximo. Si no se establece ninguna, los resultados se personalizarán por la dirección IP, lo que significa que la dirección IP se asignará a una ubicación imprecisa y se utilizará como señal de personalización.

included_primary_types[]

string

Opcional. Se incluyó el tipo de lugar principal (por ejemplo, "restaurante" o "gas_station") de https://developers.google.com/maps/documentation/places/web-service/place-types. Solo se muestra un lugar si su tipo principal está incluido en esta lista. Se pueden especificar hasta 5 valores. Si no se especifican tipos, se muestran todos los tipos de lugares.

included_region_codes[]

string

Opcional. Incluye solo los resultados en las regiones especificadas, con un máximo de 15 códigos regionales CLDR de dos caracteres. Un conjunto vacío no restringirá los resultados. Si se configuran location_restriction y included_region_codes, los resultados se ubicarán en el área de intersección.

language_code

string

Opcional. El idioma en el que se mostrarán los resultados. La configuración predeterminada es en-US. Los resultados pueden estar en varios idiomas si el idioma utilizado en input es diferente de language_code o si el lugar que se muestra no tiene una traducción del idioma local al language_code.

region_code

string

Opcional. El código de región, especificado como un código regional CLDR de dos caracteres. Esto afecta el formato de la dirección y la clasificación de los resultados, y puede influir en los resultados que se muestran. Esto no restringe los resultados a la región especificada. Para restringir los resultados a una región, usa region_code_restriction.

origin

LatLng

Opcional. Punto de origen desde el que se calculará la distancia geodésica hasta el destino (se muestra como distance_meters). Si se omite este valor, no se devolverá la distancia geodésica.

input_offset

int32

Opcional. Un desplazamiento de caracteres Unicode basado en cero de input que indica la posición del cursor en input. La posición del cursor puede influir en las predicciones que se muestran.

Si está vacío, el valor predeterminado es la longitud de input.

include_query_predictions

bool

Opcional. Si es verdadero, la respuesta incluirá predicciones de lugar y de consulta. De lo contrario, la respuesta solo mostrará predicciones del lugar.

session_token

string

Opcional. Es una cadena que identifica una sesión de Autocomplete con fines de facturación. Debe ser una string en base64 segura para URL y nombre de archivo con un máximo de 36 caracteres ASCII de longitud. De lo contrario, se muestra un error INVALID_ formato.

La sesión comienza cuando el usuario comienza a escribir una consulta y finaliza cuando selecciona un lugar y se realiza una llamada a Place Details o Address Validation. Cada sesión puede tener varias búsquedas, seguidas de una solicitud de Place Details o Address Validation. Las credenciales que se usan para cada solicitud dentro de una sesión deben pertenecer al mismo proyecto de la consola de Google Cloud. Una vez que finaliza una sesión, el token deja de ser válido, y tu app debe generar un token nuevo para cada sesión. Si se omite el parámetro session_token, o si reutilizas un token de sesión, la sesión se cobrará como si no se hubiera proporcionado un token de sesión (cada solicitud se factura por separado).

Recomendamos los siguientes lineamientos:

  • Usar tokens de sesión para todas las llamadas de Place Autocomplete
  • Genera un token nuevo para cada sesión. Se recomienda usar un UUID de la versión 4.
  • Asegúrate de que las credenciales utilizadas para todas las solicitudes de Place Autocomplete, Place Details y Address Validation dentro de una sesión pertenezcan al mismo proyecto de la consola de Cloud.
  • Asegúrate de pasar un token de sesión único para cada sesión nueva. Usar el mismo token en más de una sesión hará que cada solicitud se facture de forma individual.

LocationBias

La región en la que se buscará. Los resultados pueden estar sesgados en torno a la región especificada.

Campos

Campo de unión type.

type puede ser una de las siguientes opciones:

rectangle

Viewport

Es una viewport definida por una esquina noreste y una esquina suroeste.

circle

Circle

Es un círculo definido por un punto central y un radio.

LocationRestriction

La región en la que se buscará. Los resultados se restringirán a la región especificada.

Campos

Campo de unión type.

type puede ser una de las siguientes opciones:

rectangle

Viewport

Es una viewport definida por una esquina noreste y una esquina suroeste.

circle

Circle

Es un círculo definido por un punto central y un radio.

AutocompletePlacesResponse

Protocolo de respuesta para AutocompletePlaces.

Campos
suggestions[]

Suggestion

Contiene una lista de sugerencias, ordenadas de forma descendente según la relevancia.

Sugerencia

Un resultado de sugerencia de Autocompletar.

Campos

Campo de unión kind.

kind puede ser una de las siguientes opciones:

place_prediction

PlacePrediction

Predicción de un lugar.

query_prediction

QueryPrediction

Es una predicción para una consulta.

FormattableText

Texto que representa una predicción de lugar o de consulta. El texto se puede usar tal como está o con formato.

Campos
text

string

Texto que se puede usar tal como está o que se puede formatear con matches.

matches[]

StringRange

Una lista de rangos de strings que identifican el punto en el que coincidió la solicitud de entrada en text. Los rangos se pueden usar para dar formato a partes específicas de text. Es posible que las subcadenas no sean coincidencias exactas de input si la coincidencia se determinó por criterios distintos de la coincidencia de cadenas (por ejemplo, correcciones ortográficas o transliteraciones).

Estos valores son desplazamientos de caracteres Unicode de text. Se garantiza que los rangos se ordenarán en valores de desplazamiento crecientes.

PlacePrediction

Resultados de una predicción de Place Autocomplete.

Campos
place

string

El nombre del recurso del lugar sugerido. Este nombre se puede utilizar en otras APIs que aceptan nombres de lugares.

place_id

string

Es el identificador único del lugar sugerido. Este identificador se puede usar en otras APIs que aceptan IDs de lugar.

text

FormattableText

Contiene el nombre legible del resultado que se muestra. Para los resultados de establecimientos, suele ser el nombre y la dirección de la empresa.

Se recomienda text para los desarrolladores que deseen mostrar un solo elemento de la IU. Los desarrolladores que quieran mostrar dos elementos de la IU separados pero relacionados pueden usar structured_format en su lugar. Existen dos maneras diferentes de representar una predicción de lugar. Los usuarios no deben intentar analizar structured_format en text ni viceversa.

Este texto puede ser diferente del display_name que muestra GetPlace.

Puede estar en una combinación de idiomas si la solicitud input y language_code están en diferentes idiomas o si el lugar no tiene una traducción del idioma local a language_code.

structured_format

StructuredFormat

Es un desglose de la predicción del lugar en texto principal que contiene el nombre del lugar y un texto secundario que contiene características específicas adicionales (como una ciudad o una región).

Se recomienda structured_format para los desarrolladores que deseen mostrar dos elementos de la IU separados pero relacionados. Es posible que los desarrolladores que quieran mostrar un solo elemento de la IU usen text en su lugar. Existen dos maneras diferentes de representar una predicción de lugar. Los usuarios no deben intentar analizar structured_format en text ni viceversa.

types[]

string

Lista de tipos que se aplican a este lugar de la Tabla A o Tabla B en https://developers.google.com/maps/documentation/places/web-service/place-types.

Un tipo es una categorización de un lugar. Los lugares con tipos compartidos compartirán características similares.

distance_meters

int32

La longitud de la línea geodésica en metros desde origin si se especifica origin. Es posible que algunas predicciones, como las rutas, no propaguen este campo.

QueryPrediction

Resultados de la predicción para una predicción del autocompletado de consultas.

Campos
text

FormattableText

Es el texto de predicción. Este texto no representa un lugar, sino una consulta de texto que podría usarse en un extremo de búsqueda (por ejemplo, Text Search).

Se recomienda text para los desarrolladores que deseen mostrar un solo elemento de la IU. Los desarrolladores que quieran mostrar dos elementos de la IU separados pero relacionados pueden usar structured_format en su lugar. Existen dos formas diferentes de representar una predicción de consulta. Los usuarios no deben intentar analizar structured_format en text ni viceversa.

Puede estar en una combinación de idiomas si las solicitudes input y language_code están en diferentes idiomas o si parte de la consulta no tiene una traducción del idioma local al language_code.

structured_format

StructuredFormat

Es un desglose de la predicción de la búsqueda en un texto principal que contiene la búsqueda y un texto secundario que contiene características específicas adicionales (como una ciudad o una región).

Se recomienda structured_format para los desarrolladores que deseen mostrar dos elementos de la IU separados pero relacionados. Es posible que los desarrolladores que quieran mostrar un solo elemento de la IU usen text en su lugar. Existen dos formas diferentes de representar una predicción de consulta. Los usuarios no deben intentar analizar structured_format en text ni viceversa.

StringRange

Identifica una subcadena dentro de un texto dado.

Campos
start_offset

int32

Desplazamiento basado en cero del primer carácter Unicode de la string (inclusive)

end_offset

int32

Desplazamiento basado en cero del último carácter Unicode (exclusivo).

StructuredFormat

Contiene un desglose de una predicción de lugar o de consulta en texto principal y texto secundario.

Para las predicciones de Place, el texto principal contiene el nombre específico del lugar. En el caso de las predicciones de consulta, el texto principal contiene la consulta.

El texto secundario contiene características adicionales y aclaratorias (como una ciudad o región) para identificar aún más el lugar o definir mejor la consulta.

Campos
main_text

FormattableText

Representa el nombre del lugar o de la consulta.

secondary_text

FormattableText

Representa características adicionales y aclaratorias (como una ciudad o región) para identificar aún más el lugar o definir mejor la consulta.

Círculo

Un círculo con un objeto LatLng como centro y radio

Campos
center

LatLng

Obligatorio. Latitud y longitud centrales.

El rango de latitud debe estar entre [-90.0, 90.0]. El rango de longitud debe estar entre [-180.0, 180.0].

radius

double

Obligatorio. Radio medido en metros El radio debe estar dentro de [0.0, 50,000.0].

ContentBlock

Es un bloque de contenido que se puede publicar de manera individual.

Campos
topic

string

Indica el tema del contenido, como "resumen" o "restaurante".

content

LocalizedText

Contenido relacionado con el tema.

references

References

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles.

Referencias relacionadas con este bloque de contenido.

ContextualContent

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles.

Contenido contextual con la búsqueda de lugar

Campos
reviews[]

Review

Lista de opiniones acerca de este lugar, contexual a la búsqueda del lugar.

photos[]

Photo

Información (incluidas las referencias) sobre las fotos del lugar, contexual a la búsqueda del lugar.

justifications[]

Justification

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles.

Justificaciones para el lugar.

Justificación

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles.

Justificaciones para el lugar. Las justificaciones responden a la pregunta de por qué un lugar podría interesarle a un usuario final.

Campos

Campo de unión justification.

justification puede ser una de las siguientes opciones:

review_justification

ReviewJustification

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles.

business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles.

BusinessAvailabilityAttributesJustification

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles. justificaciones de BusinessAvailabilityAttributes. Aquí se muestran algunos atributos que tiene una empresa y que podrían interesar a los usuarios finales.

Campos
takeout

bool

Si un lugar ofrece comida para llevar.

delivery

bool

Si un lugar ofrece entregas.

dine_in

bool

Si un lugar ofrece el consumo en el lugar.

ReviewJustification

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles.

Justificaciones de opiniones de usuarios. Esto destaca una sección de la opinión del usuario que podría interesar al usuario final. Por ejemplo, si la búsqueda es "pizza a leña", la justificación de la opinión destaca el texto relevante para esa búsqueda.

Campos
highlighted_text

HighlightedText

review

Review

La opinión de la que se genera el texto destacado.

HighlightedText

El texto que se destaca por la justificación. Este es un subconjunto de la opinión en sí. La palabra exacta que se destacará está marcada con HighlightedTextRange. Es posible que haya varias palabras en el texto destacado.

Campos
text

string

highlighted_text_ranges[]

HighlightedTextRange

Es la lista de los rangos del texto destacado.

HighlightedTextRange

El rango del texto destacado.

Campos
start_index

int32

end_index

int32

EVChargeOptions

Información sobre la estación de carga de VE alojada en Place. La terminología indica que en https://afdc.energy.gov/fuels/electricity_infrastructure.html se puede cargar un automóvil a la vez. Un puerto tiene uno o más conectores. Una estación tiene uno o más puertos.

Campos
connector_count

int32

Cantidad de conectores de esta estación. Sin embargo, como algunos puertos pueden tener varios conectores, pero solo pueden cargar un automóvil a la vez (p.ej., la cantidad de conectores puede ser mayor que la cantidad total de vehículos que pueden cargarse simultáneamente).

connector_aggregation[]

ConnectorAggregation

Una lista de agregaciones de conectores de carga de VE que contienen conectores del mismo tipo y la misma velocidad de carga.

ConnectorAggregation

Información sobre la carga de VE agrupada por [tipo, max_charge_rate_kw]. Muestra la agregación de cargos del VE de conectores que tienen el mismo tipo y la tasa de carga máxima en kW.

Campos
type

EVConnectorType

El tipo de conector de esta agregación.

max_charge_rate_kw

double

La velocidad de carga máxima estática en kW de cada conector en la agregación.

count

int32

Cantidad de conectores de esta agregación.

availability_last_update_time

Timestamp

La marca de tiempo de la última actualización de la información de disponibilidad del conector en esta agregación.

available_count

int32

Cantidad de conectores de esta agregación que están disponibles actualmente.

out_of_service_count

int32

Cantidad de conectores de esta agregación que actualmente están fuera de servicio.

EVConnectorType

Consulta http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 para obtener información y contexto adicionales sobre los tipos de conectores de carga de VE.

Enumeradores
EV_CONNECTOR_TYPE_UNSPECIFIED Conector no especificado.
EV_CONNECTOR_TYPE_OTHER Otros tipos de conectores.
EV_CONNECTOR_TYPE_J1772 Conector J1772 tipo 1.
EV_CONNECTOR_TYPE_TYPE_2 conector IEC 62196 tipo 2. A menudo denominados MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Conector de tipo CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Sistema de carga combinado (CA y CC). Basada en SAE. Conector J-1772 tipo 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Sistema de carga combinado (CA y CC). Según el conector Mennekes de tipo 2
EV_CONNECTOR_TYPE_TESLA El conector TESLA genérico. Se trata de la NACS en Norteamérica, pero puede no ser parte de ella en otras partes del mundo (p.ej., CCS Combo 2 [CCS2] o GB/T). Este valor es menos representativo de un tipo de conector real y más representa la capacidad de cargar un vehículo marca Tesla en una estación de carga propiedad de la empresa.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T El tipo de GB/T corresponde al estándar GB/T de China. Este tipo abarca todos los tipos de GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET No se especificó el tomacorriente.

FuelOptions

La información más reciente sobre las opciones de combustible de una gasolinera. Esta información se actualiza con regularidad.

Campos
fuel_prices[]

FuelPrice

El último precio conocido del combustible para cada tipo de combustible que tiene esta estación. En esta estación, hay una entrada por tipo de combustible. El orden no es importante.

FuelPrice

Información sobre el precio del combustible de un tipo determinado.

Campos
type

FuelType

El tipo de combustible

price

Money

Es el precio del combustible.

update_time

Timestamp

Hora en que se actualizó por última vez el precio del combustible.

FuelType

Tipos de combustible

Enumeradores
FUEL_TYPE_UNSPECIFIED Tipo de combustible no especificado.
DIESEL Combustible diésel.
REGULAR_UNLEADED Normal sin plomo.
MIDGRADE Midgrade (89 octanos).
PREMIUM Alta calidad
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95
SP95_E10 SP95 E10
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG GLP.
E80 E 80:
E85 E 85.
METHANE Metano.
BIO_DIESEL Biocombustible
TRUCK_DIESEL Camión diésel.

GetPhotoMediaRequest

Solicitud para recuperar una foto de un lugar usando un nombre de recurso de fotos.

Campos
name

string

Obligatorio. El nombre de recurso de un archivo multimedia de fotos en el formato: places/{place_id}/photos/{photo_reference}/media.

El nombre de recurso de una foto, como se muestra en el campo photos.name de un objeto Place, tiene el formato places/{place_id}/photos/{photo_reference}. Debes agregar /media al final del recurso de foto para obtener el nombre del recurso multimedia de fotos.

max_width_px

int32

Opcional. Especifica el ancho máximo deseado de la imagen en píxeles. Si la imagen es más pequeña que los valores especificados, se mostrará la imagen original. Si la imagen es más grande en cualquiera de las dimensiones, se ajustará para coincidir con la más pequeña de las dos dimensiones, restringida a su relación de aspecto original. Las propiedades max_height_px y max_width_px aceptan un número entero entre 1 y 4800, inclusive. Si el valor no está dentro del rango permitido, se mostrará un error INVALID_ATTRIBUTE.

Se debe especificar al menos uno de los valores de max_height_px o max_width_px. Si no se especifican los valores de max_height_px ni max_width_px, se mostrará un error INVALID_{8/}.

max_height_px

int32

Opcional. Especifica la altura máxima deseada de la imagen en píxeles. Si la imagen es más pequeña que los valores especificados, se mostrará la imagen original. Si la imagen es más grande en cualquiera de las dimensiones, se ajustará para coincidir con la más pequeña de las dos dimensiones, restringida a su relación de aspecto original. Las propiedades max_height_px y max_width_px aceptan un número entero entre 1 y 4800, inclusive. Si el valor no está dentro del rango permitido, se mostrará un error INVALID_ATTRIBUTE.

Se debe especificar al menos uno de los valores de max_height_px o max_width_px. Si no se especifican los valores de max_height_px ni max_width_px, se mostrará un error INVALID_{8/}.

skip_http_redirect

bool

Opcional. Si la estableces, omite el comportamiento predeterminado de redireccionamiento HTTP y renderiza una respuesta de formato de texto (por ejemplo, en formato JSON para el caso de uso de HTTP). Si no la estableces, se emitirá un redireccionamiento HTTP para redireccionar la llamada al contenido multimedia de la imagen. Esta opción se ignora para solicitudes que no son HTTP.

GetPlaceRequest

Solicitud para recuperar un lugar según el nombre de su recurso, que es una cadena en formato places/{place_id}.

Campos
name

string

Obligatorio. El nombre del recurso de un lugar, en formato places/{place_id}.

language_code

string

Opcional. Los detalles del lugar se mostrarán en el idioma preferido si están disponibles.

Lista actual de idiomas admitidos: https://developers.google.com/maps/faq#languagesupport.

region_code

string

Opcional. Es el código Unicode de país o región (CLDR) de la ubicación de la que proviene la solicitud. Este parámetro se usa para mostrar los detalles del lugar, como el nombre del lugar específico de una región, si está disponible. El parámetro puede afectar los resultados según la ley aplicable. Para obtener más información, consulta https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Ten en cuenta que actualmente no se admiten los códigos regionales de 3 dígitos.

session_token

string

Opcional. Es una cadena que identifica una sesión de Autocomplete con fines de facturación. Debe ser una string en base64 segura para URL y nombre de archivo con un máximo de 36 caracteres ASCII de longitud. De lo contrario, se muestra un error INVALID_ formato.

La sesión comienza cuando el usuario comienza a escribir una consulta y finaliza cuando selecciona un lugar y se realiza una llamada a Place Details o Address Validation. Cada sesión puede tener varias búsquedas, seguidas de una solicitud de Place Details o Address Validation. Las credenciales que se usan para cada solicitud dentro de una sesión deben pertenecer al mismo proyecto de la consola de Google Cloud. Una vez que finaliza una sesión, el token deja de ser válido, y tu app debe generar un token nuevo para cada sesión. Si se omite el parámetro session_token, o si reutilizas un token de sesión, la sesión se cobrará como si no se hubiera proporcionado un token de sesión (cada solicitud se factura por separado).

Recomendamos los siguientes lineamientos:

  • Usar tokens de sesión para todas las llamadas de Place Autocomplete
  • Genera un token nuevo para cada sesión. Se recomienda usar un UUID de la versión 4.
  • Asegúrate de que las credenciales utilizadas para todas las solicitudes de Place Autocomplete, Place Details y Address Validation dentro de una sesión pertenezcan al mismo proyecto de la consola de Cloud.
  • Asegúrate de pasar un token de sesión único para cada sesión nueva. Usar el mismo token en más de una sesión hará que cada solicitud se facture de forma individual.

Foto

Información sobre una foto de un lugar.

Campos
name

string

Identificador. Referencia que representa la foto de este lugar y que se puede usar para volver a buscarla (también denominado nombre de "recurso" de la API: places/{place_id}/photos/{photo}).

width_px

int32

El ancho máximo disponible en píxeles.

height_px

int32

La altura máxima disponible en píxeles.

author_attributions[]

AuthorAttribution

Autores de esta foto.

PhotoMedia

Un contenido multimedia fotográfico de la API de Places

Campos
name

string

El nombre de recurso de un archivo multimedia de fotos en el formato: places/{place_id}/photos/{photo_reference}/media.

photo_uri

string

Un URI de corta duración que se puede usar para renderizar la foto.

Lugar

Toda la información que representa un lugar.

Campos
name

string

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

id

string

Es el identificador único de un lugar.

display_name

LocalizedText

Es el nombre localizado del lugar, adecuado como una descripción breve en lenguaje natural. Por ejemplo, “Google Sídney”, “Starbucks”, “Pyrmont”, etcétera.

types[]

string

Un conjunto de etiquetas de tipo para este resultado. Por ejemplo, "política" y "localidad". 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.

primary_type

string

Es el tipo principal del resultado proporcionado. Este tipo debe ser uno de los tipos admitidos de la API de Places. Por ejemplo, "restaurante", "cafetería", "aeropuerto", etc. Un lugar solo puede tener un único tipo principal. 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.

primary_type_display_name

LocalizedText

El nombre visible del tipo principal, localizado en el idioma de la solicitud, si corresponde. 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.

national_phone_number

string

Es un número de teléfono del lugar legible en formato nacional.

international_phone_number

string

Es un número de teléfono del lugar legible en formato internacional.

formatted_address

string

Una dirección completa y legible por humanos para este lugar.

short_formatted_address

string

Una dirección breve y legible por humanos para este lugar.

address_components[]

AddressComponent

Componentes repetidos para cada nivel de localidad. Ten en cuenta la siguiente información sobre el array address_components[]: - El array de componentes de dirección puede contener más componentes que el valor de formatted_address. - La matriz no necesariamente incluye todas las entidades políticas que contienen una dirección, además de las incluidas en el campo formatted_address. Para recuperar todas las entidades políticas que contienen una dirección específica, debes usar la geocodificación inversa, y pasar la latitud y la longitud de la dirección como parámetro a la solicitud. - No se garantiza que el formato de la respuesta permanezca igual entre las solicitudes. En particular, la cantidad de address_components varía según la dirección solicitada y puede cambiar con el tiempo para la misma dirección. Un componente puede cambiar de posición en el array. El tipo de componente puede cambiar. Es posible que falte un componente en particular en una respuesta posterior.

plus_code

PlusCode

Código Plus de la latitud y longitud de la ubicación del lugar

location

LatLng

Es la posición de este lugar.

viewport

Viewport

Un viewport adecuado para mostrar el lugar en un mapa de tamaño promedio.

rating

double

Una calificación entre 1.0 y 5.0, según las opiniones de los usuarios sobre este lugar.

google_maps_uri

string

Una URL que proporciona más información sobre este lugar.

website_uri

string

El sitio web autorizado para este lugar, p.ej., la página principal de una empresa. Ten en cuenta que, para los lugares que forman parte de una cadena (p.ej., una tienda IKEA), este suele ser el sitio web de la tienda individual, no de la cadena general.

reviews[]

Review

Lista de opiniones sobre este lugar, ordenadas por relevancia. Se pueden devolver hasta 5 opiniones.

regular_opening_hours

OpeningHours

Es el horario de atención habitual.

photos[]

Photo

Información (incluidas referencias) sobre las fotos de este lugar. Se puede devolver un máximo de 10 fotos.

adr_format_address

string

Dirección del lugar en microformato adr: http://microformats.org/wiki/adr.

business_status

BusinessStatus

Estado de la empresa del lugar.

price_level

PriceLevel

Indica el nivel de precio del lugar.

attributions[]

Attribution

Es un conjunto de proveedores de datos que se debe mostrar con este resultado.

icon_mask_base_uri

string

Una URL truncada a una máscara de ícono. El usuario puede acceder a diferentes tipos de ícono agregando el sufijo de tipo al final (p. ej., ".svg" o ".png").

icon_background_color

string

El color de fondo de icon_mask en formato hexadecimal, p.ej., #909CE1.

current_opening_hours

OpeningHours

El horario de atención de los próximos siete días (incluido el día de hoy) El período comienza a la medianoche de la fecha de la solicitud y termina a las 11:59 p.m. seis días después. Este campo incluye el subcampo Special_days de todas las horas, configurado para fechas que tienen horarios excepcionales.

current_secondary_opening_hours[]

OpeningHours

Contiene un array de entradas para los próximos siete días, incluida información sobre el horario secundario de una empresa. El horario secundario es diferente del horario principal de una empresa. Por ejemplo, un restaurante puede especificar el horario de atención desde el automóvil o el de entrega a domicilio como su horario secundario. Este campo propaga el subcampo de tipo, que se extrae de una lista predefinida de tipos de horarios de atención (como Drive_THROUGH, PICKUP o TakeOUT) según los tipos del lugar. Este campo incluye el subcampo Special_days de todas las horas, configurado para fechas que tienen horarios excepcionales.

regular_secondary_opening_hours[]

OpeningHours

Contiene un array de entradas para obtener información sobre el horario secundario regular de una empresa. El horario secundario es diferente del horario principal de una empresa. Por ejemplo, un restaurante puede especificar el horario de atención desde el automóvil o el de entrega a domicilio como su horario secundario. Este campo propaga el subcampo de tipo, que se extrae de una lista predefinida de tipos de horarios de atención (como Drive_THROUGH, PICKUP o TakeOUT) según los tipos del lugar.

editorial_summary

LocalizedText

Contiene un resumen del lugar. Un resumen consta de una descripción general textual y también incluye el código de idioma de estos, si corresponde. El texto de resumen debe presentarse tal como está y no se puede modificar ni alterar.

payment_options

PaymentOptions

Son las opciones de pago que acepta el lugar. Si los datos de una opción de pago no están disponibles, no se establecerá el campo de opción de pago.

parking_options

ParkingOptions

Opciones de estacionamiento que ofrece el lugar.

sub_destinations[]

SubDestination

Es una lista de subdestinos relacionados con el lugar.

fuel_options

FuelOptions

La información más reciente sobre las opciones de combustible de una gasolinera. Esta información se actualiza con regularidad.

ev_charge_options

EVChargeOptions

Información de opciones de carga para vehículos eléctricos

generative_summary

GenerativeSummary

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles.

Resumen del lugar generado por IA.

area_summary

AreaSummary

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles.

Resumen generado por IA del área en la que se encuentra el lugar.

utc_offset_minutes

int32

Cantidad de minutos de diferencia actual de la zona horaria de este lugar con respecto a la zona UTC. Esto se expresa en minutos para admitir las zonas horarias que se compensan con fracciones de una hora, p.ej., X horas y 15 minutos.

user_rating_count

int32

La cantidad total de opiniones (con o sin texto) de este lugar.

takeout

bool

Especifica si la empresa admite el servicio de comida para llevar.

delivery

bool

Especifica si la empresa admite la entrega.

dine_in

bool

Especifica si la empresa admite opciones de asientos en el interior o en el exterior.

curbside_pickup

bool

Especifica si la empresa admite los retiros en la puerta.

reservable

bool

Especifica si el lugar admite reservas.

serves_breakfast

bool

Especifica si el lugar sirve desayuno.

serves_lunch

bool

Especifica si el lugar sirve almuerzo.

serves_dinner

bool

Especifica si el lugar sirve cenas.

serves_beer

bool

Especifica si el lugar sirve cerveza.

serves_wine

bool

Especifica si el lugar sirve vino.

serves_brunch

bool

Especifica si el lugar sirve brunch.

serves_vegetarian_food

bool

Especifica si el lugar sirve comida vegetariana.

outdoor_seating

bool

Lugar con asientos al aire libre.

live_music

bool

Lugar ofrece música en vivo.

menu_for_children

bool

El lugar tiene un menú para niños.

serves_cocktails

bool

Lugar donde se sirven cocteles.

serves_dessert

bool

Lugar donde se sirven postres.

serves_coffee

bool

Lugar donde se sirve café.

good_for_children

bool

Este lugar es apto para niños.

allows_dogs

bool

El lugar admite perros.

restroom

bool

El lugar tiene sanitario.

good_for_groups

bool

El lugar tiene capacidad para grupos.

good_for_watching_sports

bool

El lugar es apto para mirar deportes.

accessibility_options

AccessibilityOptions

Incluye información sobre las opciones de accesibilidad que ofrece un lugar.

AccessibilityOptions

Incluye información sobre las opciones de accesibilidad que ofrece un lugar.

Campos
wheelchair_accessible_parking

bool

El lugar ofrece estacionamiento accesible para personas en silla de ruedas.

wheelchair_accessible_entrance

bool

Los lugares tienen entrada accesible para personas en silla de ruedas.

wheelchair_accessible_restroom

bool

El lugar tiene sanitarios accesibles para personas en silla de ruedas.

wheelchair_accessible_seating

bool

El lugar tiene asientos accesibles para personas en silla de ruedas.

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 de texto 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 campo long_name "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 "AU" en el campo short_name.

types[]

string

Un array que indica los tipos del componente de la dirección.

language_code

string

El lenguaje que se usa para dar formato a estos componentes, en notación CLDR.

AreaSummary

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles.

Resumen generado por IA del área en la que se encuentra el lugar.

Campos
content_blocks[]

ContentBlock

Bloques de contenido que componen el resumen de área. Cada bloque tiene un tema diferente sobre el área.

Atribución

Información sobre los proveedores de datos de este lugar.

Campos
provider

string

Nombre del proveedor de datos del lugar.

provider_uri

string

Es el URI del proveedor de datos del lugar.

BusinessStatus

Estado empresarial del lugar.

Enumeradores
BUSINESS_STATUS_UNSPECIFIED Valor predeterminado Este valor no se usa.
OPERATIONAL El establecimiento está en funcionamiento, no necesariamente abierto ahora.
CLOSED_TEMPORARILY El establecimiento está cerrado temporalmente.
CLOSED_PERMANENTLY El establecimiento está cerrado permanentemente.

GenerativeSummary

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles.

Resumen del lugar generado por IA.

Campos
overview

LocalizedText

La descripción general del lugar.

description

LocalizedText

Corresponde a una descripción detallada del lugar.

references

References

Referencias que se usan para generar la descripción del resumen.

OpeningHours

Incluye información sobre el horario de atención del lugar.

Campos
periods[]

Period

Los períodos en los que este lugar está abierto durante la semana. Los períodos se muestran en orden cronológico; a partir del domingo en la zona horaria del lugar. Un valor vacío (pero no ausente) indica un lugar que nunca está abierto, p.ej., porque está cerrado temporalmente por renovaciones.

weekday_descriptions[]

string

Cadenas localizadas que describen el horario de atención del lugar; una cadena para cada día de la semana. Estará vacío si el horario es desconocido o si no se pudo convertir a texto localizado. Ejemplo: "Sun: 18:00–06:00"

secondary_hours_type

SecondaryHoursType

Es una cadena de tipo que se usa para identificar el tipo de horario secundario.

special_days[]

SpecialDay

Información estructurada para los días especiales que corresponden al período que abarca el horario de atención devuelto. Los días especiales son aquellos que pueden afectar el horario de atención de un lugar (p.ej., la Navidad). Se establece en current_opening_hours y current_secondary_opening_hours si hay horarios excepcionales.

open_now

bool

¿Este lugar está abierto ahora? Siempre presente, a menos que no tengamos datos sobre la hora del día o la zona horaria para este horario de atención.

Período

Un período en el que el lugar permanece en estado open_now.

Campos
open

Point

La hora a la que el lugar comienza a estar abierto.

close

Point

La hora a la que el lugar comienza a cerrar.

Punto

Puntos de estado que cambian.

Campos
date

Date

La fecha en la zona horaria local del lugar.

truncated

bool

Indica si este extremo se truncó o no. El truncamiento ocurre cuando las horas reales se encuentran fuera de los horarios en los que estamos dispuestos a devolver horas entre ellas, por lo que truncamos las horas a estos límites. Esto garantiza que se devuelvan como máximo 24 * 7 horas a partir de la medianoche del día de la solicitud.

day

int32

Es un día de la semana, como un número entero dentro del rango 0-6. 0 es domingo, 1 es lunes, etcétera.

hour

int32

Indica la hora en 2 dígitos. Va de 00 a 23.

minute

int32

El minuto en 2 dígitos. Va de 00 a 59.

SecondaryHoursType

Es un tipo que se usa para identificar el tipo de horario secundario.

Enumeradores
SECONDARY_HOURS_TYPE_UNSPECIFIED El valor predeterminado cuando no se especifica el tipo de hora secundaria.
DRIVE_THROUGH La hora del retiro desde el automóvil para bancos, restaurantes o farmacias
HAPPY_HOUR La hora feliz
DELIVERY Es la hora de entrega.
TAKEOUT Es la hora de la comida para llevar.
KITCHEN La hora de cocina.
BREAKFAST La hora del desayuno
LUNCH La hora del almuerzo
DINNER La hora de la cena.
BRUNCH La hora del brunch
PICKUP Es la hora de retiro.
ACCESS Las horas de acceso de los lugares de almacenamiento.
SENIOR_HOURS El horario especial para adultos mayores.
ONLINE_SERVICE_HOURS El horario de atención en línea

SpecialDay

Información estructurada para los días especiales que corresponden al período que abarca el horario de atención devuelto. Los días especiales son aquellos que pueden afectar el horario de atención de un lugar (p.ej., la Navidad).

Campos
date

Date

La fecha de este día especial.

ParkingOptions

Información sobre las opciones de estacionamiento del lugar. Un estacionamiento podría admitir más de una opción al mismo tiempo.

Campos
free_parking_lot

bool

El lugar ofrece estacionamiento gratuito.

paid_parking_lot

bool

El lugar ofrece estacionamientos pagados.

free_street_parking

bool

Lugar ofrece estacionamiento en la calle gratuito.

paid_street_parking

bool

El lugar ofrece estacionamiento pagado en la calle.

valet_parking

bool

El lugar ofrece servicio de estacionamiento.

free_garage_parking

bool

Lugar ofrece estacionamiento gratuito en cochera.

paid_garage_parking

bool

El lugar ofrece estacionamiento en cochera pagado.

PaymentOptions

Son las opciones de pago que acepta el lugar.

Campos
accepts_credit_cards

bool

El lugar acepta tarjetas de crédito como forma de pago.

accepts_debit_cards

bool

Place acepta tarjetas de débito como pago.

accepts_cash_only

bool

El lugar acepta solo pago en efectivo. Es posible que los lugares con este atributo acepten otras formas de pago.

accepts_nfc

bool

El lugar acepta pagos NFC.

PlusCode

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

Campos
global_code

string

Código global (completo) del sitio, como "9FWM33GV+HQ", que representa un área de 1/8000 por 1/8000 grados (~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 el nombre con formato de una entidad de referencia.

SubDestination

Coloca el nombre y el ID del recurso de los subdestinos que se relacionan con el lugar. Por ejemplo, distintas terminales son destinos diferentes de un aeropuerto.

Campos
name

string

Es el nombre del recurso del subdestino.

id

string

Es el ID de lugar del destino secundario.

PriceLevel

Indica el nivel de precio del lugar.

Enumeradores
PRICE_LEVEL_UNSPECIFIED El nivel de precio del lugar no está especificado o es desconocido.
PRICE_LEVEL_FREE El lugar ofrece servicios gratuitos.
PRICE_LEVEL_INEXPENSIVE Place proporciona servicios económicos.
PRICE_LEVEL_MODERATE Place proporciona servicios con precios moderados.
PRICE_LEVEL_EXPENSIVE Place proporciona servicios costosos.
PRICE_LEVEL_VERY_EXPENSIVE Place proporciona servicios muy costosos.

Referencias

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles.

Referencia con la que se relaciona el contenido generativo.

Campos
reviews[]

Review

Opiniones que funcionan como referencias.

places[]

string

La lista de nombres de recursos de los lugares a los que se hace referencia. Este nombre se puede usar en otras APIs que aceptan nombres de recursos de Places.

Repaso

Incluye información sobre una opinión sobre un lugar.

Campos
name

string

Referencia que representa la opinión de este lugar, que se puede usar para volver a buscar esta opinión (también denominado nombre de "recurso" de la API: places/{place_id}/reviews/{review}).

relative_publish_time_description

string

Es una cadena de tiempo reciente con formato que expresa el tiempo de revisión en relación con la hora actual en un formato adecuado para el idioma y el país.

text

LocalizedText

Corresponde al texto localizado de la opinión.

original_text

LocalizedText

El texto de la opinión en su idioma original

rating

double

Un número entre 1.0 y 5.0, también llamado número de estrellas.

author_attribution

AuthorAttribution

Autor de esta opinión.

publish_time

Timestamp

Marca de tiempo de la revisión

SearchNearbyRequest

Solicita el protocolo para la función Buscar en alrededores.

Campos
language_code

string

Los detalles del lugar se mostrarán en el idioma preferido si están disponibles. Si no se especifica el código de idioma o no se reconoce, se pueden mostrar detalles del lugar de cualquier idioma, con preferencia por el inglés (si existen esos detalles).

Lista actual de idiomas admitidos: https://developers.google.com/maps/faq#languagesupport.

region_code

string

Es el código Unicode de país o región (CLDR) de la ubicación de la que proviene la solicitud. Este parámetro se usa para mostrar los detalles del lugar, como el nombre del lugar específico de una región, si está disponible. El parámetro puede afectar los resultados según la ley aplicable.

Para obtener más información, consulta https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Ten en cuenta que actualmente no se admiten los códigos regionales de 3 dígitos.

included_types[]

string

Se incluye el tipo de lugar (p. ej., "restaurante" o "gas_station") de https://developers.google.com/maps/documentation/places/web-service/place-types.

Se pueden especificar hasta 50 tipos de la Tabla A.

Si hay algún tipo en conflicto, es decir, si aparece un tipo tanto en include_types como en el_excluded_types, se mostrará un error INVALID_{8/}.

Si se especifica un tipo de lugar con varias restricciones de tipo, solo se muestran los lugares que cumplen con todas las restricciones. Por ejemplo, si tenemos {included_types = ["restaurant"],excluded_primary_types = ["restaurant"]}, los lugares devueltos proporcionan servicios relacionados con "restaurantes", pero no operan principalmente como "restaurantes".

excluded_types[]

string

Tipo de lugar excluido (p. ej., "restaurante" o "gas_station") de https://developers.google.com/maps/documentation/places/web-service/place-types.

Se pueden especificar hasta 50 tipos de la Tabla A.

Si el cliente proporciona include_types (p.ej., restaurante) yexcluded_types (p.ej., cafetería), la respuesta debe incluir lugares que pertenecen a un restaurante, pero no a una cafetería. La respuesta incluye lugares que coinciden con, al menos, uno de los valores include_types y ninguno de los excluidos.

Si hay algún tipo en conflicto, es decir, si aparece un tipo tanto en include_types como en el_excluded_types, se mostrará un error INVALID_{8/}.

Si se especifica un tipo de lugar con varias restricciones de tipo, solo se muestran los lugares que cumplen con todas las restricciones. Por ejemplo, si tenemos {included_types = ["restaurant"],excluded_primary_types = ["restaurant"]}, los lugares devueltos proporcionan servicios relacionados con "restaurantes", pero no operan principalmente como "restaurantes".

included_primary_types[]

string

Se incluyó el tipo de lugar principal (p.ej., "restaurante" o "gas_station") de https://developers.google.com/maps/documentation/places/web-service/place-types. Un lugar solo puede tener un tipo principal asociado a la tabla de tipos admitidos.

Se pueden especificar hasta 50 tipos de la Tabla A.

Si hay tipos principales en conflicto, es decir, si aparece un tipo tanto en include_primary_types como en excluidos_primary_types, se mostrará un error INVALID_{8/}.

Si se especifica un tipo de lugar con varias restricciones de tipo, solo se muestran los lugares que cumplen con todas las restricciones. Por ejemplo, si tenemos {included_types = ["restaurant"],excluded_primary_types = ["restaurant"]}, los lugares devueltos proporcionan servicios relacionados con "restaurantes", pero no operan principalmente como "restaurantes".

excluded_primary_types[]

string

Se excluyó el tipo de lugar principal (p.ej., "restaurante" o "gas_station") de https://developers.google.com/maps/documentation/places/web-service/place-types.

Se pueden especificar hasta 50 tipos de la Tabla A.

Si hay tipos principales en conflicto, es decir, si aparece un tipo tanto en include_primary_types como en excluidos_primary_types, se mostrará un error INVALID_{8/}.

Si se especifica un tipo de lugar con varias restricciones de tipo, solo se muestran los lugares que cumplen con todas las restricciones. Por ejemplo, si tenemos {included_types = ["restaurant"],excluded_primary_types = ["restaurant"]}, los lugares devueltos proporcionan servicios relacionados con "restaurantes", pero no operan principalmente como "restaurantes".

max_result_count

int32

Cantidad máxima de resultados que se mostrarán Debe ser un valor entre 1 y 20 (predeterminado), inclusive. Si no estableces el número, volverá al límite superior. Si el número se establece como negativo o excede el límite superior, se muestra un error INVALID_ATTRIBUTE.

location_restriction

LocationRestriction

Obligatorio. La región en la que se buscará.

rank_preference

RankPreference

Cómo se clasificarán los resultados en la respuesta.

LocationRestriction

La región en la que se buscará.

Campos

Campo de unión type.

type puede ser una de las siguientes opciones:

circle

Circle

Es un círculo definido por el punto central y el radio.

RankPreference

Cómo se clasificarán los resultados en la respuesta.

Enumeradores
RANK_PREFERENCE_UNSPECIFIED No se estableció el valor de RankPreference. Se usará la clasificación por POPULARITY de forma predeterminada.
DISTANCE Clasifica los resultados por distancia.
POPULARITY Clasifica los resultados por popularidad.

SearchNearbyResponse

Protocolo de respuesta para Buscar en alrededores.

Campos
places[]

Place

Una lista de lugares que cumplen con los requisitos de los usuarios, como los tipos y la cantidad de lugares, y una restricción de ubicación específica.

SearchTextRequest

Solicita el protocolo para SearchText.

Campos
text_query

string

Obligatorio. Es la consulta de texto para la búsqueda textual.

language_code

string

Los detalles del lugar se mostrarán en el idioma preferido si están disponibles. Si no se especifica el código de idioma o no se reconoce, se pueden mostrar detalles del lugar de cualquier idioma, con preferencia por el inglés (si existen esos detalles).

Lista actual de idiomas admitidos: https://developers.google.com/maps/faq#languagesupport.

region_code

string

Es el código Unicode de país o región (CLDR) de la ubicación de la que proviene la solicitud. Este parámetro se usa para mostrar los detalles del lugar, como el nombre del lugar específico de una región, si está disponible. El parámetro puede afectar los resultados según la ley aplicable.

Para obtener más información, consulta https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Ten en cuenta que actualmente no se admiten los códigos regionales de 3 dígitos.

rank_preference

RankPreference

Cómo se clasificarán los resultados en la respuesta.

included_type

string

Es el tipo de lugar solicitado. Lista completa de los tipos admitidos: https://developers.google.com/maps/documentation/places/web-service/place-types Solo se admite un tipo incluido.

open_now

bool

Se usa para restringir la búsqueda a los lugares que están abiertos en ese momento. El valor predeterminado es falso.

min_rating

double

Filtra los resultados cuya calificación promedio de los usuarios sea estrictamente inferior a este límite. Un valor válido debe ser un número de punto flotante entre 0 y 5 (inclusive) con una cadencia de 0.5, es decir, [0, 0.5, 1.0, ... , 5.0] inclusive. La calificación de entrada se redondeará al valor máximo de 0.5(límite) más cercano. Por ejemplo, una calificación de 0.6 eliminará todos los resultados con una calificación inferior a 1.0.

max_result_count
(deprecated)

int32

Obsoleto: usa page_size en su lugar.

La cantidad máxima de resultados que se pueden mostrar por página. Si la cantidad de resultados disponibles es mayor que max_result_count, se muestra un next_page_token que se puede pasar a page_token para obtener la siguiente página de resultados en solicitudes posteriores. Si se proporciona 0 o no se proporciona ningún valor, se utiliza el valor predeterminado de 20. El valor máximo es 20; los valores superiores a 20 se forzarán a 20. Los valores negativos mostrarán un error INVALID_{8/}.

Si se especifican max_result_count y page_size, se ignorará max_result_count.

page_size

int32

Opcional. La cantidad máxima de resultados que se pueden mostrar por página. Si la cantidad de resultados disponibles es mayor que page_size, se muestra un next_page_token que se puede pasar a page_token para obtener la siguiente página de resultados en solicitudes posteriores. Si se proporciona 0 o no se proporciona ningún valor, se utiliza el valor predeterminado de 20. El valor máximo es 20; los valores superiores a 20 se establecerán en 20. Los valores negativos mostrarán un error INVALID_{8/}.

Si se especifican max_result_count y page_size, se ignorará max_result_count.

page_token

string

Opcional. Un token de página, recibido de una llamada anterior de TextSearch. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los parámetros excepto page_token, page_size y max_result_count proporcionados a TextSearch deben coincidir con la llamada inicial que proporcionó el token de la página. De lo contrario, se muestra un error INVALID_ formato.

price_levels[]

PriceLevel

Se usa para restringir la búsqueda a lugares marcados con determinados niveles de precios. Los usuarios pueden elegir cualquier combinación de niveles de precios. De forma predeterminada, se seleccionan todos los niveles de precios.

strict_type_filtering

bool

Se usa para establecer un filtro de tipos estricto para include_type. Si se configura como true, solo se mostrarán resultados del mismo tipo. El valor predeterminado es falso.

location_bias

LocationBias

La región en la que se buscará. Esta ubicación sirve como sesgo, lo que significa que podrían devolverse resultados en torno a una ubicación determinada. No se puede establecer junto con location_restriction.

location_restriction

LocationRestriction

La región en la que se buscará. Esta ubicación sirve como una restricción, lo que significa que no se mostrarán resultados fuera de la ubicación determinada. No se puede establecer junto con location_bias.

ev_options

EVOptions

Opcional. Configura las opciones de búsqueda de VE para una solicitud de búsqueda de lugar.

EVOptions

Opciones de VE que se pueden buscar de una solicitud de búsqueda de lugar.

Campos
minimum_charging_rate_kw

double

Opcional. Velocidad de carga mínima requerida en kilovatios. Se filtrará un lugar con una tasa de carga inferior a la tarifa especificada.

connector_types[]

EVConnectorType

Opcional. La lista de tipos de conectores de VE preferidos. Se filtrará un lugar que no admita ninguno de los tipos de conectores que figuran en la lista.

LocationBias

La región en la que se buscará. Esta ubicación sirve como sesgo, lo que significa que podrían devolverse resultados en torno a una ubicación determinada.

Campos

Campo de unión type.

type puede ser una de las siguientes opciones:

rectangle

Viewport

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 suroeste del viewport del rectángulo. rectangle.low().latitude() no puede ser mayor que rectangle.high().latitude(). El resultado será un rango de latitud vacío. Un viewport rectangular no puede tener un ancho superior a 180 grados.

circle

Circle

Es un círculo definido por el punto central y el radio.

LocationRestriction

La región en la que se buscará. Esta ubicación sirve como una restricción, lo que significa que no se mostrarán resultados fuera de la ubicación determinada.

Campos

Campo de unión type.

type puede ser una de las siguientes opciones:

rectangle

Viewport

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 suroeste del viewport del rectángulo. rectangle.low().latitude() no puede ser mayor que rectangle.high().latitude(). El resultado será un rango de latitud vacío. Un viewport rectangular no puede tener un ancho superior a 180 grados.

RankPreference

Cómo se clasificarán los resultados en la respuesta.

Enumeradores
RANK_PREFERENCE_UNSPECIFIED Para una consulta categórica como “Restaurantes en la Ciudad de Nueva York”, RELEVANCE es la opción predeterminada. Para consultas no categóricas, como “Mountain View, CA”, te recomendamos que no establezcas RankPreference.
DISTANCE Clasifica los resultados por distancia.
RELEVANCE Clasifica los resultados por relevancia. Orden de clasificación determinado por la pila de clasificación normal.

SearchTextResponse

Protocolo de respuesta para SearchText.

Campos
places[]

Place

Una lista de lugares que cumplen con los criterios de búsqueda de texto del usuario.

contextual_contents[]

ContextualContent

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más detalles.

Una lista de contenidos contextuales en la que cada entrada se asocia al lugar correspondiente en el mismo índice en el campo "places". Se prefiere el contenido relevante para text_query en la solicitud. Si el contenido contextual no está disponible para uno de los lugares, se mostrará contenido no contextual. Estará en blanco solo cuando el contenido no esté disponible para este lugar. Esta lista debe tener tantas entradas como la lista de lugares, si se solicita.

next_page_token

string

Un token que se puede enviar como page_token para recuperar la página siguiente. Si este campo se omite o está vacío, no habrá páginas posteriores.