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 dizeplaces/
ö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 olarakoperating_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).