Package google.maps.areainsights.v1

Dizin

AreaInsights

Places Aggregate RPC için hizmet tanımı.

ComputeInsights

rpc ComputeInsights(ComputeInsightsRequest) returns (ComputeInsightsResponse)

Bu yöntem, alan, yer türü, çalışma durumu, fiyat seviyesi ve puanlar gibi çeşitli filtreleri kullanarak alanlarla ilgili analizler almanıza olanak tanır. Şu anda yalnızca "sayı" ve "yer" analizleri desteklenmektedir. "Sayı" analizleriyle "Kaliforniya'da faaliyet gösteren, uygun fiyatlı ve ortalama puanı en az 4 yıldız olan kaç restoran var?" gibi soruları yanıtlayabilirsiniz (Daha fazla bilgi için insight enum bölümüne bakın). "Yerler" analizleriyle, istenen filtreyle hangi yerlerin eşleştiğini belirleyebilirsiniz. Müşteriler daha sonra bu yer kaynak adlarını kullanarak Places API'yi kullanarak her bir yer hakkında daha fazla bilgi edinebilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

ComputeInsightsRequest

ComputeInsights RPC isteği.

Alanlar
insights[]

Insight

Zorunlu. Hesaplanacak analizler. Şu anda yalnızca INSIGHT_COUNT ve INSIGHT_PLACES desteklenmektedir.
filter

Filter

Zorunlu. Analiz filtresi.

ComputeInsightsResponse

ComputeInsights RPC'ye verilen yanıt.

Alanlar
place_insights[]

PlaceInsight

Insights.INSIGHT_PLACES sonucu.
count

int64

Insights.INSIGHT_COUNT sonucu.

Filtre

ComputeInsights RPC için filtreler.

Alanlar
location_filter

LocationFilter

Zorunlu. Sonuçları, konum filtreleri tarafından belirtilen alanda bulunan yerlerle sınırlar.
type_filter

TypeFilter

Zorunlu. Yer türü filtreleri.
operating_status[]

OperatingStatus

İsteğe bağlı. Sonuçları, faaliyet durumu bu listeye dahil olan yerlerle kısıtlar. operating_status ayarlanmazsa varsayılan olarak OPERATING_STATUS_OPERATIONAL kullanılır.
price_levels[]

PriceLevel

İsteğe bağlı. Sonuçları, fiyat düzeyi bu listeye dahil olan yerlerle sınırlandırır. price_levels ayarlanmazsa sonuçlara tüm fiyat seviyeleri dahil edilir.
rating_filter

RatingFilter

İsteğe bağlı. Sonuçları, ortalama kullanıcı puanları rating_filter tarafından belirtilen aralıkta olan yerlerle sınırlandırır. rating_filter ayarlanmamışsa tüm puanlar sonuca dahil edilir.

Analiz

Desteklenen analizler.

Sıralamalar
INSIGHT_UNSPECIFIED Belirtilmedi.
INSIGHT_COUNT

Sayı analizini inceleyin.

Bu analiz belirtildiğinde ComputeInsights, belirtilen filtre ölçütleriyle eşleşen yerlerin sayısını döndürür.

Örnek istek:

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

Örnek yanıt:

{
  "count": 1234
}
INSIGHT_PLACES

Yerleri iade etme

Bu analiz belirtildiğinde ComputeInsights, belirtilen filtre ölçütleriyle eşleşen yer kimliklerini döndürür.

Örnek istek:

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

Örnek yanıt:

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

LocationFilter

Konum filtreleri.

Analizin alakalı konumunu belirtir.

Alanlar
Birlik alanı area. Aşağıdakilerden biri belirtilmelidir. area yalnızca aşağıdakilerden biri olabilir:
circle

Circle

Alan, daire şeklinde gösterilir.
region

Region

Bölge olarak alan.
custom_area

CustomArea

Poligonla belirtilen özel alan.

Daire

Daireler, bir merkez noktası ve yarıçapı (metre cinsinden) ile tanımlanır.

Alanlar
radius

int32

İsteğe bağlı. Çemberin metre cinsinden yarıçapı
Birlik alanı center. Dairenin merkezi. center yalnızca aşağıdakilerden biri olabilir:
lat_lng

LatLng

Dairenin merkezinin enlemi ve boylamı.
place

string

Biçim: places/PLACE_ID biçiminde olmalıdır. Burada PLACE_ID, bir yerin benzersiz tanımlayıcısıdır. Örneğin: places/ChIJgUbEo8cfqokR5lP9_Wh_DaM.

CustomArea

Özel Alan.

Alanlar
polygon

Polygon

Zorunlu. Poligon olarak temsil edilen özel alan

Poligon

Çokgenler, saat yönünün tersine sıralanmış bir dizi bağlı koordinatla temsil edilir. Koordinatlar kapalı bir döngü oluşturur ve dolu bir bölge tanımlar. İlk ve son koordinatlar eşdeğerdir ve aynı değerleri içermelidir. Bu biçim, GeoJSON poligonlarının basitleştirilmiş bir sürümüdür (yalnızca saat yönünün tersine tek bir dış halka desteklenir).

Alanlar
coordinates[]

LatLng

İsteğe bağlı. Poligonu tanımlayan koordinatlar.

Bölge

Bölge, şehirler, posta kodları, ilçeler, eyaletler vb. gibi coğrafi bir sınırdır.

Alanlar
Birlik alanı region. Coğrafi bir bölgeyi tanımlar. Tek seferde yalnızca bir bölge türü (ör. yer) belirtilebilir. region yalnızca aşağıdakilerden biri olabilir:
place

string

Belirli bir coğrafi bölgenin benzersiz tanımlayıcısı.

OperatingStatus

Yerin çalışma durumu.

Sıralamalar
OPERATING_STATUS_UNSPECIFIED Belirtilmedi. Bu değer kullanılmamalıdır.
OPERATING_STATUS_OPERATIONAL Yer, belirtilen çalışma saatlerinde açık ve faaliyettedir.
OPERATING_STATUS_PERMANENTLY_CLOSED Yer artık faaliyette değil.
OPERATING_STATUS_TEMPORARILY_CLOSED Yer geçici olarak kapalıdır ve ileride yeniden açılması beklenmektedir.

PlaceInsight

Bir yerle ilgili bilgileri içerir.

Alanlar
place

string

Yerin benzersiz tanımlayıcısı. Bu kaynak adı, Places API kullanılarak yerle ilgili ayrıntıları almak için kullanılabilir.

PriceLevel

Yerin fiyat düzeyi.

Sıralamalar
PRICE_LEVEL_UNSPECIFIED Belirtilmedi. Bu değer kullanılmamalıdır.
PRICE_LEVEL_FREE Tesis ücretsiz hizmetler sunuyor.
PRICE_LEVEL_INEXPENSIVE Uygun fiyatlı hizmetler sunuluyor.
PRICE_LEVEL_MODERATE Orta düzeyde fiyatlı hizmetler sunuluyor.
PRICE_LEVEL_EXPENSIVE Burası pahalı hizmetler sunuyor.
PRICE_LEVEL_VERY_EXPENSIVE Burası çok pahalı hizmetler sunuyor.

RatingFilter

Ortalama kullanıcı puanı filtreleri.

Alanlar
min_rating

float

İsteğe bağlı. Sonuçları, ortalama kullanıcı puanı min_rating değerinden büyük veya eşit olan yerlerle sınırlandırır. Değerler 1,0 ile 5,0 arasında olmalıdır.
max_rating

float

İsteğe bağlı. Sonuçları, ortalama kullanıcı puanı max_rating'ten kesinlikle düşük veya max_rating'e eşit olan yerlerle sınırlandırır. Değerler 1,0 ile 5,0 arasında olmalıdır.

TypeFilter

Yer türü filtreleri.

Yalnızca Tablo a'daki yer türleri desteklenir.

Bir yerin yalnızca tek bir birincil türü olabilir. Örneğin, birincil tür "mexican_restaurant" veya "steak_house" olabilir. Bir yerin birincil türüne göre sonuçları filtrelemek için included_primary_types ve excluded_primary_types özelliklerini kullanın.

Bir yerin birden fazla tür değeri de olabilir. Örneğin, bir restoranın şu türleri olabilir: "seafood_restaurant", "restaurant", "food", "point_of_interest", "establishment". Bir yerle ilişkili tür listesinde sonuçları filtrelemek için included_types ve excluded_types parametrelerini kullanın.

Birden fazla tür kısıtlaması içeren bir arama yapıldığında yalnızca tüm kısıtlamaları karşılayan yerler döndürülür. Örneğin, {"included_types": ["restaurant"], "excluded_primary_types": ["steak_house"]} değerini belirtirseniz döndürülen yerler "restaurant" ile ilgili hizmetler sunar ancak birincil olarak "steak_house" olarak faaliyet göstermez.

Çakışan tür varsa (ör. bir tür hem included_types hem de excluded_types türlerinde veya included_primary_types ve excluded_primary_types türlerinde görünüyorsa) INVALID_ARGUMENT hatası döndürülür.

included_types veya included_primary_types'den biri ayarlanmalıdır.

Alanlar
included_types[]

string

İsteğe bağlı. Dahil edilen yer türleri.
excluded_types[]

string

İsteğe bağlı. Hariç tutulan yer türleri.
included_primary_types[]

string

İsteğe bağlı. Birincil yer türleri dahil edildi.
excluded_primary_types[]

string

İsteğe bağlı. Hariç tutulan birincil yer türleri.