Este documento proporciona una descripción general clara de todos los parámetros dentro del API de Places Insights Analizaremos cada uno en detalle, ofreceremos estadísticas y prácticas para ayudarte a usar esta herramienta para tus necesidades de datos geográficos.
La API de Places Insights te permite realizar varias funciones clave:
- Recuento de lugares: Determina la cantidad de lugares que coinciden con datos específicos. como el tipo de ubicación, el estado operativo, el nivel de precio y las calificaciones.
- Recuperar detalles del lugar: Obtén los nombres de los lugares que cumplen con los filtros especificados, recupera información más detallada mediante el API de Places.
- Filtros flexibles: Aplique filtros completos para obtener estadísticas precisas.
Entre los filtros disponibles, se incluyen los siguientes:
- Área geográfica (círculo, región o polígono personalizado)
- Tipos de lugares
- Estado operativo
- Niveles de precios
- Rangos de clasificación
Parámetros obligatorios
En esta sección, se abarcan los parámetros requeridos al emitir una solicitud a la API de Places Insights Cada solicitud debe proporcionar la siguiente información:
- Un tipo de estadística.
- Un filtro de ubicación y un filtro de tipo
Estadística
Especifica el tipo de estadísticas que quieres calcular. Los siguientes tipos de estadísticas compatibles:
INSIGHT_COUNT
: Muestra la cantidad de lugares que coinciden con los criterios de filtro.INSIGHT_PLACES
: Muestra los IDs de lugar que coinciden con los criterios del filtro.
Nota: Si se selecciona esta opción, la API de Places Insights muestra los IDs de lugar
solo si count
es 100 o menos.
Filtro
Especifica los criterios para filtrar lugares. Como mínimo, debes especificar el
LocationFilter
y TypeFilter
.
Filtro de ubicación
Un filtro de ubicación puede tener uno de los siguientes tipos:
circle
: Define un área como círculo con un centro y un radio.region
: Define un área como una región.custom_area
: Define un área como un polígono personalizado.
Círculo
Si seleccionas tu área geográfica como círculo, debes proporcionar un center
.
y una radius
. El centro puede ser una latitud y longitud, o el lugar
ID del centro del círculo.
- centro:
lat_lng
: La latitud y la longitud del centro del círculo. Latitudes debe ser un número entre -90, 90, inclusive. La longitud debe ser un número entre -180, 180, inclusive.place
: Es el ID de lugar del centro del círculo. Ten en cuenta que solo el modo lugares son compatibles. Esta cadena debe comenzar con el prefijoplaces/
.
radius
: Radio del círculo en metros Este número debe ser positivo.
Región
Puedes definir tu área como una región con el parámetro place
. Cómo usar un ID de lugar
que representa un área geográfica (como un área representable por un
polígono). Por ejemplo, el ID de lugar de Tampa, FL es
places/ChIJ4dG5s4K3wogRY7SWr4kTX6c
Tipos de regiones no compatibles | |
---|---|
establishment |
place_of_worship |
floor |
post_box |
food |
postal_code_suffix |
general_contractor |
room |
geocode |
street_address |
health |
street_number |
intersection |
sublocality_level_5 |
landmark |
subpremise |
Puedes usar el campo types
de una llamada a la API de Geocoding para determinar la
tipo de ubicación o dirección asociada con un ID de lugar; por ejemplo, si se trata de un
ciudad, vecindario o país.
Área personalizada
Define el área de un polígono personalizado mediante coordenadas.
Puedes visitar https://geojson.io/ para dibujar un polígono personalizado y ingresar esas coordenadas en la solicitud. Un polígono debe tener al menos 4. coordenadas, en las que la primera y la última son idénticas. Además del primera y última coordenada, no debe haber ninguna otra coordenada duplicada. Por ejemplo:
"coordinates":[ { "latitude":37.776, "longitude":-122.666 }, { "latitude":37.130, "longitude":-121.898 }, { "latitude":37.326, "longitude":-121.598 }, { "latitude":37.912, "longitude":-122.247 }, { "latitude":37.776, "longitude":-122.666 } ]
Filtro de tipos
Especifica los tipos de lugares que se incluirán o excluirán. Para obtener una lista de ambas
y los tipos de lugares secundarios que admite la API de Places Insights, consulta la Tabla
A en la guía Tipos de lugares para la API de Places
(Nuevo). Se debe tener al menos un tipo de included_types
o included_primary_types
incluidos.
included_types
: Lista de tipos de lugares incluidos.excluded_types
: Lista de tipos de lugares excluidos.included_primary_types
: Lista de tipos de lugares principales incluidos.excluded_primary_types
: Lista de tipos de lugares principales excluidos.
Para obtener más información acerca de cómo funcionan los filtros de tipo y los tipos de lugares, consulta Más información sobre tipos filtros.
Parámetros opcionales
Los tres filtros restantes son opcionales:
operating_status
: Especifica los estados de los lugares que se incluirán o excluirán. La configuración predeterminada es filtrar poroperating_status: OPERATING_STATUS_OPERATIONAL
. (un valor específico).price_levels
: Especifica los niveles de precio de los lugares. La configuración predeterminada es "no". filtrado (todos los niveles de precios se incluyen en los resultados).rating_filter
: Especifica el rango de calificación de los lugares. La configuración predeterminada es "no". filtrado (todas las calificaciones se incluyen en los resultados).
Estado operativo
Filtra según el estado operativo (por ejemplo, operativo o temporal). cerrado).
Nivel de precio
Filtra según el nivel de precio (por ejemplo, gratuito, moderado o costoso).
Filtro de clasificación
Filtra los lugares según las calificaciones promedio de los usuarios. Ambos campos son opcionales y, si se omiten, se incluirán de forma predeterminada también lugares que no tienen una calificación.
min_rating
: Es la calificación mínima promedio de los usuarios (entre 1.0 y 5.0).max_rating
: Indica la calificación promedio máxima de los usuarios (entre 1.0 y 5.0).