En esta sección, se abarca una serie de solicitudes de ejemplo a la API de Places Insights.
Para usar computeInsights
, envía una solicitud HTTP POST en el siguiente formulario:
https://areainsights.googleapis.com/v1:computeInsights
Mostrar lugares dentro de un círculo
Devolver todos los restaurantes que se encuentren en un radio de 200 m de Trafalgar Square, Londres
- El área de búsqueda es un círculo centrado en una latitud y longitud específicas. El radio de este círculo es de 200 metros, lo que determina el tamaño del en una sola área de búsqueda.
- El tipo de lugar solicitado es restaurante, y se pasa con
included_types
dentro detype_filters
. - El recuento se solicita con
INSIGHTS_COUNT
y los IDs de lugares se solicitan conINSIGHTS_PLACES
.
{ "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"], "filter": { "location_filter": { "circle": { "lat_lng": { "latitude": 51.508, "longitude": -0.128}, "radius": 200 } }, "type_filter": { "included_types": "restaurant" } } }
Excluir tipos de lugares
También puedes excluir tipos de lugares del recuento.
La siguiente solicitud es la misma que el primer ejemplo, pero agrega
excluded_types
a type_filters
. Puedes usar una cadena o un array de cadenas para included_types
y excluded_types
.
En este ejemplo, se excluyen dos tipos de lugares: cafe
y bakery
, de la
Cantidad de restaurant
.
{ "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"], "filter": { "location_filter": { "circle": { "lat_lng": { "latitude": 51.508, "longitude": -0.128}, "radius": 200 } }, "type_filter": { "included_types": "restaurant", "excluded_types": [ "cafe", "bakery" ] } } }
Usar tipo principal
En este ejemplo, se modifica la solicitud del primer ejemplo para incluir solo los lugares que tienen un primaryType
de restaurant
en el recuento.
{ "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"], "filter": { "location_filter": { "circle": { "lat_lng": { "latitude": 51.508, "longitude": -0.128}, "radius": 200 } }, "type_filter": { "included_primary_types": "restaurant" } } }
Polígono personalizado
En este ejemplo, se muestra cómo usar un polígono personalizado para definir los términos de búsqueda.
en una sola área
de almacenamiento en etapa intermedia. Ten en cuenta que especificar INSIGHTS_PLACES
restringe la búsqueda a
áreas lo suficientemente pequeñas como para mostrar hasta 100 ID de lugar. Para áreas más grandes, utiliza
INSIGHTS_COUNT
para omitir esta limitación, de modo que el servicio no tenga que
los IDs de lugar individuales.
Al igual que antes, el tipo de lugar que se usa es restaurant
. En este ejemplo, también se presenta
otros tres filtros:
operating_status
: En este ejemplo, solo se cuentan los lugares operativos.price_level
: En este ejemplo, solo se contabilizan los precios económicos y de precios moderados. lugares.rating_filter
: En este ejemplo, solo se cuentan los lugares con una puntuación de opiniones entre 4.0 y 5.0.
{ "insights": [ "INSIGHT_COUNT" ], "filter": { "location_filter": { "custom_area": { "polygon": { "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 } ] } } }, "type_filter": { "included_types": "restaurant" }, "operating_status": [ "OPERATING_STATUS_OPERATIONAL" ], "price_levels": [ "PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE" ], "rating_filter": { "min_rating": 4.0, "max_rating": 5.0 } } }
Área geográfica
En este ejemplo, se usa un ID de lugar de área geográfica para establecer el área de búsqueda.
Estos IDs de lugar incluyen la geometría de un lugar, como un pueblo o una ciudad. El
el ID de lugar que se usa aquí es ChIJiQHsW0m3j4ARm69rRkrUF3w
, que corresponde al
ciudad de Mountain View, California.
Cuando pasas el ID de lugar a la API de Places Insights, se establece el área de búsqueda en los límites.
del área geográfica. El ID de lugar se pasa con place
, en el formato.
places/<place_ID>
Puedes obtener un ID de lugar de área geográfica de cualquiera de las siguientes maneras:
- API de Geocoding
- Búsqueda de texto (nueva)
- Nearby Search (nuevo)
- API de Address Validation
- Place Autocomplete
{ "insights": [ "INSIGHT_COUNT" ], "filter": { "location_filter": { "region": { "place": "places/ChIJiQHsW0m3j4ARm69rRkrUF3w" } }, "type_filter": { "included_types": [ "restaurant" ] } } }