Exemplos

Nesta seção, abordamos uma série de exemplos de solicitações para a API Places Insights.

Para usar computeInsights, envie uma solicitação HTTP POST no seguinte formulário:

https://areainsights.googleapis.com/v1:computeInsights

Mostrar lugares dentro de um círculo

Mostrar todos os restaurantes em um raio de 200 metros da Trafalgar Square, em Londres.

  • A área de pesquisa é um círculo centralizado em uma latitude e uma longitude específicas. O raio desse círculo é de 200 metros, o que determina o tamanho do área de pesquisa.
  • O tipo de lugar solicitado é "restaurante", e ele é transmitido usando included_types em type_filters.
  • A contagem é solicitada usando INSIGHTS_COUNT, e os IDs de lugar são solicitado usando 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 lugar

Também é possível excluir tipos de lugar da contagem.

A solicitação a seguir é igual ao primeiro exemplo, mas acrescenta excluded_types para type_filters. É possível usar uma string ou uma matriz de strings para included_types e excluded_types.

Este exemplo exclui dois tipos de lugar: cafe e bakery, do 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 o tipo primário

Este exemplo modifica a solicitação do primeiro exemplo para incluir apenas lugares que tenham um primaryType de restaurant na contagem.

{
  "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

Este exemplo demonstra como usar um polígono personalizado para definir uma pesquisa área Lembre-se de que especificar INSIGHTS_PLACES restringe a pesquisa a áreas pequenas o suficiente para retornar até 100 IDs de lugar. Para áreas maiores, use INSIGHTS_COUNT para ignorar essa limitação de modo que o serviço não precise retornar IDs de lugares individuais.

Como antes, o tipo de lugar usado é restaurant. Este exemplo também apresenta outros três filtros:

  • operating_status: este exemplo conta apenas locais operacionais.
  • price_level: este exemplo considera apenas as opções baratas e com preço moderado. lugares.
  • rating_filter: este exemplo conta apenas lugares com pontuação de avaliação entre 4.0 e 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

Este exemplo usa um ID de lugar de área geográfica para definir a área de pesquisa. Esses IDs incluem a geometria de um local, como uma cidade. O ID de lugar usado aqui é ChIJiQHsW0m3j4ARm69rRkrUF3w, que corresponde ao cidade de Mountain View, Califórnia.

Transmitir o ID de lugar para a API Places Insights define a área de pesquisa como os limites. da área geográfica. O ID do lugar é transmitido usando place, no formato places/<place_ID>.

Você pode obter um ID de lugar de área geográfica de uma das seguintes maneiras:

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