Ejemplos

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 de type_filters.
  • El recuento se solicita con INSIGHTS_COUNT y los IDs de lugares se solicitan con INSIGHTS_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:

{
    "insights": [
        "INSIGHT_COUNT"
    ],
    "filter": {
        "location_filter": {
            "region": {
                "place": "places/ChIJiQHsW0m3j4ARm69rRkrUF3w"
            }
        },
        "type_filter": {
            "included_types": [
                "restaurant"
            ]
        }
    }
}