İstek parametreleri

Bu belgede, Places Insights API. Her birini ayrıntılı olarak ele alacak, analizler ve en iyi en iyi uygulamaları paylaşacağım.

Places Insights API'si birkaç temel işlevi yerine getirmenize olanak tanır:

  • Yerleri say: Belirli yerlerle eşleşen yerlerin sayısını belirleyin konum türü, faaliyet durumu, fiyat düzeyi ve derecelendirmeler gibi ölçütlere göre belirlenir.
  • Yer ayrıntılarını al: filtre oluşturabilir, ardından Yerler API'si.
  • Esnek filtreleme: Kesin analizler elde etmek için kapsamlı filtreler uygulayın. Kullanılabilen filtreler şunlardır:
    • Coğrafi alan (daire, bölge veya özel poligon)
    • Yer türleri
    • Faaliyet durumu
    • Fiyat seviyeleri
    • Derecelendirme aralıkları

Gerekli parametreler

Bu bölümde, Places Insights API. Her talepte aşağıdaki bilgiler sağlanmalıdır:

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

Analiz

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: Bu seçenek belirlenirse Places Insights API yer kimliklerini döndürür. yalnızca count 100 veya daha küçükse.

Filtre

Yerlere filtre uygulama ölçütlerini belirtir. En azından, projenizin LocationFilter ve TypeFilter.

Yer filtresi

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

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

Coğrafi bölgenizi daire olarak seçerseniz bir center belirtmeniz gerekir ve radius. Merkez, bir enlem ve boylam ya da Dairenin merkezinin kimliği.

  • merkez:
    • lat_lng: Çemberin merkezinin enlem ve boylamı. Enlemler -90, 90 dahil olmak üzere bu sayılar arasında bir sayı olmalıdır. Boylam bir sayı olmalıdır -180, 180 arası (180 dahil) olmalıdır.
    • place: Dairenin merkezinin yer kimliği. Yalnızca noktanın yer destekleniyor. Bu dize places/ önekiyle başlamalıdır.
  • radius: Çemberin metre cinsinden yarıçapı. Bu sayı pozitif olmalıdır.
Bölge

place parametresini kullanarak bulunduğunuz bölgeyi bölge olarak tanımlayabilirsiniz. Yer kimliği kullanın temsil eden bir coğrafi alanı (ör. bir poligon) ekleyin. Örneğin, Tampa, FL'nin yer kimliği places/ChIJ4dG5s4K3wogRY7SWr4kTX6c

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

Bir Geocoding API çağrısındaki types alanını kullanarak bir yer kimliğiyle ilişkili konum veya adresin türü (örneğin, mahalle veya ülke gibi görünür.

Özel alan

Koordinatlar kullanarak özel bir çokgenin alanını tanımlar.

Özel bir poligon çizmek için https://geojson.io/ adresini ziyaret edebilir ve bu koordinatları isteğe girebilirsiniz. Bir poligon en az 4 olmalıdır koordinatlarını (ör. ilk ve son koordinatların aynı olduğu) gösterir. yanında koordinatla ilgili başka hiçbir yinelenen koordinat olmamalıdır. Ö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
   }
]

Filtre türü

Dahil edilecek veya hariç tutulacak yer türlerini belirtir. Hem birincil hem de ve Places Insights API'nin desteklediği ikincil yer türleri için aşağıdaki A (Yerler API'si için Yer Türleri kılavuzu altında) (Yeni). En az bir included_types veya included_primary_types türü olmalıdır dahil.

  • included_types: Dahil edilen yer türlerinin listesi.
  • excluded_types: Hariç tutulan yer türlerinin listesi.
  • included_primary_types: Dahil edilen birincil yer türlerinin listesi.
  • excluded_primary_types: Hariç tutulan birincil yer türlerinin listesi.

Tür filtrelerinin ve yer türlerinin nasıl çalıştığı hakkında daha fazla bilgi edinmek için türle ilgili daha fazla bilgi edinin filtreleri hakkında daha fazla bilgi edinin.

İsteğe bağlı parametreler

Geri kalan üç filtre isteğe bağlıdır:

  • operating_status: Dahil edilecek veya hariç tutulacak yerlerin durumlarını belirtir. Varsayılan olarak operating_status: OPERATING_STATUS_OPERATIONAL ölçütüne göre filtreleme yapılır (belirli bir değer).
  • price_levels: Yerlerin fiyat seviyelerini belirtir. Varsayılan olarak hayır değerine ayarlanır filtreleme (tüm fiyat düzeyleri sonuçlara dahil edilir).
  • rating_filter: Yerlerin değerlendirme aralığını belirtir. Varsayılan olarak hayır değerine ayarlanır filtreleme (tüm derecelendirmeler sonuçlara dahildir).

Faaliyet durumu

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

Fiyat düzeyi

Fiyat Düzeyi'ne göre filtreleyin (ör. ücretsiz, orta veya pahalı).

Puan filtresi

Yerleri, ortalama kullanıcı puanlarına göre filtreler. Bu alanların ikisi de isteğe bağlıdır ve atlanırsa varsayılan olarak bir derecelendirmeye sahip değil.

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