Przykłady

W tej sekcji omawiamy serię przykładowych żądań do interfejsu Places Insights API.

Aby użyć metody computeInsights, prześlij żądanie HTTP POST w tym formularzu:

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

Zwracanie miejsc w kręgu

Zwróć wszystkie restauracje znajdujące się w promieniu 200 m od Trafalgar Square w Londynie.

  • Obszar wyszukiwania to okrąg wyśrodkowany na określonej szerokości i długości geograficznej. Promień tego okręgu wynosi 200 metrów, co określa wielkość obszar wyszukiwania.
  • Żądany typ miejsca to restauracja, który jest przekazywany za pomocą funkcji included_types w: type_filters.
  • Żądane jest za pomocą funkcji INSIGHTS_COUNT, a identyfikatory miejsc są wysłano żądanie za pomocą: 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" }
  }
}

Wyklucz typy miejsc

Możesz też wykluczyć różne rodzaje miejsc.

Poniższe żądanie jest takie samo jak pierwsze, ale dodaje dodanie excluded_types do type_filters. Możesz użyć ciągu znaków lub tablicy ciągów znaków included_types i excluded_types.

Ten przykład wyklucza 2 typy miejsc: cafe i bakery, z sekcji Liczba: 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"
            ]
        }
    }
}

Użyj typu głównego

Ten przykład zmienia żądanie z pierwszego przykładu, tak aby uwzględnić tylko miejsca. , których liczba wynosi primaryType o wartości 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" }
  }
}

Wielokąt niestandardowy

Ten przykład pokazuje, jak za pomocą wielokąta niestandardowego zdefiniować wyszukiwanie w pobliżu. Pamiętaj, że określenie INSIGHTS_PLACES ogranicza wyszukiwanie do na tyle małych, by zmieścić do 100 identyfikatorów miejsc. W przypadku większych obszarów użyj INSIGHTS_COUNT, aby ominąć to ograniczenie i dzięki temu usługa nie będzie musiała wykonywać zwracają identyfikatory poszczególnych miejsc.

Tak jak wcześniej używany typ miejsca to restaurant. Ten przykład przedstawia także trzy inne filtry:

  • operating_status: w tym przykładzie zliczane są tylko miejsca, w których działa system.
  • price_level: w tym przykładzie liczy się tylko niedrogie i umiarkowane ceny miejsc.
  • rating_filter: w tym przykładzie uwzględniono tylko miejsca z oceną w zakresie 4.0 i 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 }
    }
}

Obszar geograficzny

W tym przykładzie używamy identyfikatora miejsca Obszar geograficzny. Te identyfikatory miejsc obejmują geometrię miejsca, np. miejscowości. Identyfikator miejsca to ChIJiQHsW0m3j4ARm69rRkrUF3w, który odpowiada miastu Mountain View w Kalifornii.

Przekazanie identyfikatora miejsca do interfejsu Places Insights API powoduje, że obszar wyszukiwania jest ograniczony do granic obszaru geograficznego. Identyfikator miejsca jest przekazywany za pomocą place w formacie places/<place_ID>

Identyfikator miejsca na obszarze geograficznym można uzyskać w jeden z tych sposobów:

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