Package google.maps.areainsights.v1

Indeks

AreaInsights

Definisi layanan untuk RPC Agregat Places.

ComputeInsights

rpc ComputeInsights(ComputeInsightsRequest) returns (ComputeInsightsResponse)

Metode ini memungkinkan Anda mengambil insight tentang area menggunakan berbagai filter seperti: area, jenis tempat, status operasi, tingkat harga, dan rating. Saat ini, insight "jumlah" dan "tempat" didukung. Dengan insight "jumlah", Anda dapat menjawab pertanyaan seperti "Berapa banyak restoran yang beroperasi, murah, dan memiliki rating rata-rata minimal 4 bintang di California" (lihat enum insight untuk mengetahui detail selengkapnya). Dengan insight "tempat", Anda dapat menentukan tempat mana yang cocok dengan filter yang diminta. Klien kemudian dapat menggunakan nama resource tempat tersebut untuk mengambil detail selengkapnya tentang setiap tempat menggunakan Places API.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

ComputeInsightsRequest

Permintaan untuk RPC ComputeInsights.

Kolom
insights[]

Insight

Wajib. Insight yang akan dihitung. Saat ini hanya INSIGHT_COUNT dan INSIGHT_PLACES yang didukung.
filter

Filter

Wajib. Filter insight.

ComputeInsightsResponse

Respons untuk RPC ComputeInsights.

Kolom
place_insights[]

PlaceInsight

Hasil untuk Insights.INSIGHT_PLACES.
count

int64

Hasil untuk Insights.INSIGHT_COUNT.

Filter

Filter untuk RPC ComputeInsights.

Kolom
location_filter

LocationFilter

Wajib. Membatasi hasil ke tempat yang berada di area yang ditentukan oleh filter lokasi.
type_filter

TypeFilter

Wajib. Filter jenis tempat.
operating_status[]

OperatingStatus

Opsional. Membatasi hasil ke tempat yang status operasinya disertakan dalam daftar ini. Jika operating_status tidak ditetapkan, OPERATING_STATUS_OPERATIONAL akan digunakan sebagai default.
price_levels[]

PriceLevel

Opsional. Membatasi hasil ke tempat yang tingkat harganya disertakan dalam daftar ini. Jika price_levels tidak ditetapkan, semua tingkat harga akan disertakan dalam hasil.
rating_filter

RatingFilter

Opsional. Membatasi hasil ke tempat yang rating pengguna rata-ratanya berada dalam rentang yang ditentukan oleh rating_filter. Jika rating_filter tidak ditetapkan, semua rating akan disertakan dalam hasil.

Insight

Insight yang didukung.

Enum
INSIGHT_UNSPECIFIED Tidak Ditentukan.
INSIGHT_COUNT

Insight jumlah.

Jika insight ini ditentukan, ComputeInsights akan menampilkan jumlah tempat yang cocok dengan kriteria filter yang ditentukan.

Contoh permintaan:

{
  "insights": ["INSIGHT_COUNT"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

Contoh respons:

{
  "count": 1234
}
INSIGHT_PLACES

Tempat Pengembalian

Jika insight ini ditentukan, ComputeInsights akan menampilkan ID tempat yang cocok dengan kriteria filter yang ditentukan.

Contoh permintaan:

{
  "insights": ["INSIGHT_PLACES"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

Contoh respons:

{
  "placeInsights": [
    {"place": "places/ABC"},
    {"place": "places/PQR"},
    {"place": "places/XYZ"}
  ]
}

LocationFilter

Filter lokasi.

Menentukan area minat untuk insight.

Kolom
Kolom union area. Salah satu hal berikut harus ditentukan. area hanya dapat berupa salah satu dari berikut:
circle

Circle

Area sebagai lingkaran.
region

Region

Area sebagai wilayah.
custom_area

CustomArea

Area kustom yang ditentukan oleh poligon.

Lingkaran

Lingkaran ditentukan oleh titik tengah dan radius dalam meter.

Kolom
radius

int32

Opsional. Radius lingkaran dalam meter
Kolom union center. Pusat lingkaran. center hanya dapat berupa salah satu dari berikut:
lat_lng

LatLng

Lintang dan bujur pusat lingkaran.
place

string

Format: Harus dalam format places/PLACE_ID, dengan PLACE_ID adalah ID unik tempat. Misalnya: places/ChIJgUbEo8cfqokR5lP9_Wh_DaM.

CustomArea

Area Kustom.

Kolom
polygon

Polygon

Wajib. Area kustom yang direpresentasikan sebagai poligon

Poligon

Poligon diwakili oleh serangkaian koordinat yang terhubung dalam urutan berlawanan arah jarum jam. Koordinat membentuk loop tertutup dan menentukan wilayah yang terisi. Koordinat pertama dan terakhir setara, dan harus berisi nilai yang sama. Format ini adalah versi sederhana dari poligon GeoJSON (kami hanya mendukung satu cincin luar berlawanan arah jarum jam).

Kolom
coordinates[]

LatLng

Opsional. Koordinat yang menentukan poligon.

Wilayah

Wilayah adalah batas geografis seperti: kota, kode pos, county, negara bagian, dll.

Kolom
Kolom union region. Menentukan wilayah geografis. Hanya satu jenis wilayah (misalnya, tempat) yang dapat ditentukan dalam satu waktu. region hanya dapat berupa salah satu dari berikut:
place

string

ID unik wilayah geografis tertentu.

OperatingStatus

Status operasional tempat.

Enum
OPERATING_STATUS_UNSPECIFIED Tidak ditentukan. Nilai ini tidak boleh digunakan.
OPERATING_STATUS_OPERATIONAL Tempat ini beroperasi dan buka selama jam buka yang ditentukan.
OPERATING_STATUS_PERMANENTLY_CLOSED Tempat ini tidak lagi beroperasi.
OPERATING_STATUS_TEMPORARILY_CLOSED Tempat ini tutup sementara dan diperkirakan akan dibuka kembali pada masa mendatang.

PlaceInsight

Menyimpan informasi tentang suatu tempat

Kolom
place

string

ID unik tempat. Nama resource ini dapat digunakan untuk mengambil detail tentang tempat menggunakan Places API.

PriceLevel

Tingkat harga tempat.

Enum
PRICE_LEVEL_UNSPECIFIED Tidak ditentukan. Nilai ini tidak boleh digunakan.
PRICE_LEVEL_FREE Tempat menyediakan layanan gratis.
PRICE_LEVEL_INEXPENSIVE Tempat ini menyediakan layanan yang murah.
PRICE_LEVEL_MODERATE Tempat ini menyediakan layanan dengan harga sedang.
PRICE_LEVEL_EXPENSIVE Tempat ini menyediakan layanan yang mahal.
PRICE_LEVEL_VERY_EXPENSIVE Tempat ini menyediakan layanan yang sangat mahal.

RatingFilter

Filter rating pengguna rata-rata.

Kolom
min_rating

float

Opsional. Membatasi hasil ke tempat yang memiliki rating pengguna rata-rata lebih besar dari atau sama dengan min_rating. Nilai harus antara 1,0 dan 5,0.
max_rating

float

Opsional. Membatasi hasil ke tempat yang memiliki rating pengguna rata-rata yang benar-benar kurang dari atau sama dengan max_rating. Nilai harus antara 1,0 dan 5,0.

TypeFilter

Filter jenis tempat.

Hanya jenis Tempat dari Tabel a yang didukung.

Tempat hanya dapat memiliki satu jenis utama yang terkait dengannya. Misalnya, jenis utama dapat berupa "mexican_restaurant" atau "steak_house". Gunakan included_primary_types dan excluded_primary_types untuk memfilter hasil berdasarkan jenis utama tempat.

Tempat juga dapat memiliki beberapa nilai jenis yang terkait dengannya. Misalnya, restoran mungkin memiliki jenis berikut: "seafood_restaurant", "restaurant", "food", "point_of_interest", "establishment". Gunakan included_types dan excluded_types untuk memfilter hasil pada daftar jenis yang terkait dengan tempat.

Jika penelusuran ditentukan dengan beberapa batasan jenis, hanya tempat yang memenuhi semua batasan yang akan ditampilkan. Misalnya, jika Anda menentukan {"included_types": ["restaurant"], "excluded_primary_types": ["steak_house"]}, tempat yang ditampilkan akan menyediakan layanan terkait "restaurant", tetapi tidak beroperasi terutama sebagai "steak_house".

Jika ada jenis yang bertentangan, yaitu jenis yang muncul dalam jenis included_types dan excluded_types atau included_primary_types dan excluded_primary_types, error INVALID_ARGUMENT akan ditampilkan.

Salah satu dari included_types atau included_primary_types harus ditetapkan.

Kolom
included_types[]

string

Opsional. Jenis Tempat yang disertakan.
excluded_types[]

string

Opsional. Jenis Tempat yang dikecualikan.
included_primary_types[]

string

Opsional. Menyertakan jenis Tempat utama.
excluded_primary_types[]

string

Opsional. Jenis Tempat utama yang dikecualikan.