İstek parametreleri

Bu belgede, Places Insights API'nin istek parametreleri açıklanmakta ve bu hizmeti kullanmayla ilgili analizler ile en iyi uygulamalar yer almaktadır.

Places Insights API, birkaç önemli işlevi gerçekleştirmenize olanak tanır:

  • Yerleri sayma: Konum türü, çalışma durumu, fiyat seviyesi ve puanlar gibi belirli ölçütlerle eşleşen yerlerin sayısını belirleyin.
  • Yer ayrıntılarını alma: Belirtilen filtreleri karşılayan yerlerin adlarını alın, ardından Places API'yi kullanarak daha ayrıntılı bilgiler alın.
  • Esnek filtreleme: Hassas analizler elde etmek için kapsamlı filtreler uygulayın. Kullanılabilir filtreler şunlardır:
    • Coğrafi alan (daire, bölge veya özel poligon)
    • Yer türleri
    • Faaliyet durumu
    • Fiyat düzeyleri
    • Derecelendirme aralıkları

Gerekli parametreler

Bu bölümde, Places Insights API'ye istek gönderirken gerekli olan parametreler açıklanmaktadır. Her istek aşağıdakileri sağlamalıdır:

  • Bir analiz türü.
  • Bir konum filtresi ve tür filtresi.

Analiz türü

Hesaplamak istediğiniz analizlerin türünü belirtir. Aşağıdaki analiz türleri desteklenir:

  • INSIGHT_COUNT: Filtre ölçütleriyle eşleşen yerlerin sayısını döndürür.

  • INSIGHT_PLACES: Filtre ölçütleriyle eşleşen yer kimliklerini döndürür.

    Not: INSIGHT_PLACES seçeneğini belirlerseniz Places Insights API, yalnızca count 100 veya daha az olduğunda yer kimliklerini döndürür.

Filtreler

Yerleri filtreleme ölçütlerini belirtir. En azından LocationFilter ve TypeFilter öğelerini belirtmeniz gerekir.

Yer filtresi

Konum filtresi aşağıdaki türlerden biri olabilir:

  • circle: Bir alanı, merkezi ve yarıçapı olan bir daire olarak tanımlar.
  • region: Bir alanı bölge olarak tanımlar.
  • customArea: Bir alanı özel poligon olarak tanımlar.
Daire

Coğrafi bölgenizi daire olarak seçerseniz bir center ve bir radius sağlamanız gerekir. Merkez, bir enlem ve boylam veya dairenin merkezinin yer kimliği olabilir.

  • center:
    • latLng: Dairenin merkezinin enlemi ve boylamı. Enlemler, -90 ile 90 arasında (-90 ve 90 dahil) bir sayı olmalıdır. Boylam, -180 ile 180 arasında (bu değerler dahil) bir sayı olmalıdır.
    • place: Dairenin merkezinin yer kimliği. Yalnızca nokta yerlerinin desteklendiğini unutmayın. Bu dize places/ ön ekiyle başlamalıdır.
  • radius: Dairenin yarıçapı (metre cinsinden). Bu sayı pozitif olmalıdır.
Bölge

place parametresine bir yer kimliği göndererek bölgenizi bölge olarak tanımlayın. Yer kimliği, bir coğrafi alanı (ör. poligonla temsil edilebilen bir alan) temsil eder. Örneğin, Tampa, Florida'nın yer kimliği places/ChIJ4dG5s4K3wogRY7SWr4kTX6c'tür. Tüm yer kimliklerinin iyi tanımlanmış bir geometriye sahip olmadığını ve bu durumlarda Places Insights API'nin 404 hata kodu döndürdüğünü unutmayın.

Aşağıdaki tabloda desteklenmeyen bölge türleri listelenmiştir. Bir yer kimliğinin desteklenmeyen bir bölge türünü temsil edip etmediğini belirlemek için yer kimliğini bir Coğrafi Kodlama API isteğinde iletin. Yanıtta, yer kimliğiyle ilişkili bölgeleri (ör. city, neighborhood veya country) listeleyen type dizisi yer alır.

Desteklenmeyen Bölge Türleri
establishment place_of_worship
floor post_box
food postal_code_suffix
general_contractor room
geocode street_address
health street_number
intersection sublocality_level_5
landmark subpremise
Özel alan

Enlem ve boylam koordinatlarını kullanarak özel bir poligonun alanını tanımlar.

Özel bir poligon çizmek ve bu koordinatları isteğe girmek için https://geojson.io/ adresini ziyaret edebilirsiniz. Poligonlar en az 4 koordinata sahip olmalıdır. Bu koordinatların ilk ve sonu aynı olmalıdır. Sağlanan koordinatlardan en az 3'ü benzersiz olmalıdır. İlk ve son koordinatların dışında yinelenen koordinat bulunmamalıdır. Ayrıca, bitişik olmayan kenarların kesişmesine ve 180 derece uzunluğundaki kenarlara izin verilmez (yani bitişik köşeler zıt kutuplarda olamaz).

Örneğin:

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

Tür filtresi

Dahil edilecek veya hariç tutulacak yer türlerini belirtir. Places Insights API'nin desteklediği hem birincil hem de ikincil yer türlerinin listesi için Places API (Yeni) Yer Türleri bölümündeki Tablo A'ya bakın. En az bir includedTypes veya includedPrimaryTypes türü belirtmeniz gerekir.

  • includedTypes: Dahil edilen yer türlerinin listesi.
  • excludedTypes: Hariç tutulan yer türlerinin listesi.
  • includedPrimaryTypes: Dahil edilen birincil yer türlerinin listesi.
  • excludedPrimaryTypes: Hariç tutulan birincil yer türlerinin listesi.

Tür filtrelerinin ve yer türlerinin işleyiş şekli hakkında daha fazla bilgi edinmek için tür filtreleri hakkında daha fazla bilgi başlıklı makaleyi inceleyin.

İsteğe bağlı parametreler

Bu filtreler isteğe bağlıdır:

  • operatingStatus: Dahil edilecek veya hariç tutulacak yerlerin durumlarını belirtir. Varsayılan olarak operatingStatus: OPERATING_STATUS_OPERATIONAL değerine göre filtreleme yapar (belirli bir değer).
  • priceLevels: Yerlerin fiyat düzeylerini belirtir. Varsayılan olarak filtreleme yapılmaz (tüm fiyat seviyeleri sonuçlara dahil edilir).
  • ratingFilter: Yerlerin puan aralığını belirtir. Varsayılan olarak filtreleme yapılmaz (tüm derecelendirmeler sonuçlara dahil edilir).

Faaliyet durumu

Faaliyet Durumu'na (ör. faaliyette veya geçici olarak kapalı) göre filtreleyin.

Fiyat düzeyi

Fiyat Seviyesi'ne (ör. ücretsiz, orta veya pahalı) göre filtreleme yapın.

Puan filtresi

Yerleri ortalama kullanıcı puanlarına göre filtreler. Bu iki alan da isteğe bağlıdır. Bu nedenle, atlanırlarsa varsayılan olarak puanı olmayan yerleri de içerirler.

  • minRating: Minimum ortalama kullanıcı puanı (1,0 ile 5,0 arasında).
  • maxRating: Maksimum ortalama kullanıcı puanı (1,0 ile 5,0 arasında).