Contoh

Bagian ini membahas serangkaian contoh permintaan ke Places Insights API.

Untuk menggunakan computeInsights, kirimkan permintaan POST HTTP dalam bentuk berikut:

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

Menampilkan tempat dalam lingkaran

Kembalikan semua restoran dalam radius 200 m dari Trafalgar Square, London.

  • Area penelusuran adalah lingkaran yang berpusat pada lintang dan bujur tertentu. Jari-jari lingkaran ini adalah 200 meter, yang menentukan ukuran area penelusuran.
  • Jenis tempat yang diminta adalah restoran, dan ini diteruskan menggunakan included_types di type_filters.
  • Jumlah diminta menggunakan INSIGHTS_COUNT, dan ID tempat diminta menggunakan 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" }
  }
}

Kecualikan jenis tempat

Anda juga dapat mengecualikan jenis tempat dari jumlah.

Permintaan berikut sama dengan contoh pertama, tetapi menambahkan excluded_types menjadi type_filters. Anda dapat menggunakan string atau array string untuk included_types dan excluded_types.

Contoh ini mengecualikan dua jenis tempat: cafe dan bakery, dari Jumlah 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"
            ]
        }
    }
}

Gunakan jenis utama

Contoh ini memodifikasi permintaan dari contoh pertama untuk menyertakan tempat saja yang memiliki primaryType restaurant dalam hitungan.

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

Poligon kustom

Contoh ini menunjukkan cara menggunakan poligon kustom untuk menentukan penelusuran Anda area tersebut. Perlu diingat bahwa menetapkan INSIGHTS_PLACES akan membatasi penelusuran hanya area yang cukup kecil untuk mengembalikan hingga 100 ID tempat. Untuk area yang lebih luas, gunakan INSIGHTS_COUNT untuk mengabaikan batasan ini sehingga layanan tidak perlu mengembalikan ID tempat individual.

Seperti sebelumnya, jenis tempat yang digunakan adalah restaurant. Contoh ini juga memperkenalkan tiga filter lainnya:

  • operating_status: Contoh ini hanya menghitung tempat operasional.
  • price_level: Contoh ini hanya menghitung harga yang murah dan terjangkau tempat.
  • rating_filter: Contoh ini hanya menghitung tempat dengan skor ulasan antara 4.0 dan 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 geografis

Contoh ini menggunakan ID tempat Area Geografis untuk menetapkan area penelusuran. ID tempat ini mencakup geometri suatu tempat, seperti kota. Tujuan ID tempat yang digunakan di sini adalah ChIJiQHsW0m3j4ARm69rRkrUF3w, yang sesuai dengan kota Mountain View, California.

Meneruskan ID tempat ke Places Insights API akan menetapkan area penelusuran ke batas dari area geografis. ID tempat diteruskan menggunakan place, dalam format places/<place_ID>.

Anda bisa mendapatkan ID tempat Area Geografis dengan salah satu cara berikut:

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