Esempi

Questa sezione riguarda una serie di richieste di esempio all'API Places Insights.

Per utilizzare computeInsights, invia una richiesta POST HTTP con il seguente modulo:

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

Restituire i luoghi all'interno di un cerchio

Restituire tutti i ristoranti entro un raggio di 200 metri da Trafalgar Square, Londra.

  • L'area di ricerca è un cerchio centrato su una latitudine e una longitudine specifiche. Il raggio di questo cerchio è di 200 metri, il che determina le dimensioni dell'area di ricerca.
  • Il tipo di luogo richiesto è ristorante e questo viene passato utilizzando included_types in type_filters.
  • Il conteggio viene richiesto utilizzando INSIGHTS_COUNT e gli ID luogo vengono richiesti utilizzando 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" }
  }
}

Escludere i tipi di luoghi

Puoi anche escludere dal conteggio i tipi di luoghi.

La seguente richiesta è uguale al primo esempio, ma aggiunge excluded_types a type_filters. Puoi utilizzare una stringa o un array di stringhe per included_types e excluded_types.

Questo esempio esclude due tipi di luogo: cafe e bakery, dalla Conteggio 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"
            ]
        }
    }
}

Utilizza il tipo principale

Questo esempio modifica la richiesta del primo esempio per includere solo luoghi che presentano un valore di primaryType pari a restaurant.

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

Poligono personalizzato

Questo esempio mostra come utilizzare un poligono personalizzato per definire l'area di ricerca. Tieni presente che specificando INSIGHTS_PLACES limita la ricerca a aree di dimensioni sufficientemente piccole da restituire fino a 100 ID luogo. Per aree più grandi, usa INSIGHTS_COUNT per bypassare questa limitazione in modo che il servizio non debba restituiscono gli ID dei singoli luoghi.

Come in precedenza, il tipo di luogo utilizzato è restaurant. Questo esempio introduce anche altri tre filtri:

  • operating_status: questo esempio conteggia solo i luoghi operativi.
  • price_level: questo esempio conta solo i prezzi economici e i prezzi moderati luoghi.
  • rating_filter: in questo esempio vengono conteggiati solo i luoghi con un punteggio delle recensioni compreso tra 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 }
    }
}

Area geografica

In questo esempio viene utilizzato un ID luogo dell'area geografica per impostare l'area di ricerca. Questi ID luogo includono la geometria di un luogo, ad esempio una città o un paese. La L'ID luogo utilizzato qui è ChIJiQHsW0m3j4ARm69rRkrUF3w, che corrisponde alla città di Mountain View, California.

Se passi l'ID luogo all'API di Dati di Places, l'area di ricerca viene impostata sui confini dell'area geografica. L'ID luogo viene trasmesso utilizzando place, nel formato places/<place_ID>.

Puoi ottenere un ID luogo dell'area geografica in uno dei seguenti modi:

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