Filtre parametreleri

Aşağıdaki tabloda açıklanan parametreleri kullanarak Places Count işlevlerine filtre uygulayabilirsiniz. Gerekli parametrelerin her işlev için farklı olduğunu unutmayın:

Filtre adı ve değeri büyük/küçük harfe duyarlıdır. Bunları tabloda göründükleri şekilde belirtmeniz gerekir. Aksi takdirde sorgu, geçersiz bağımsız değişken hatası döndürür.

Filtre Adı Açıklama Tür Desteklenen Değerler
geography

PLACES_COUNT, PLACES_COUNT_PER_TYPE ve PLACES_COUNT_PER_H3 için

Arama yapılacak alanı belirtir. Point, LineString ve Polygon gibi her tür GEOGRAPHY desteklenir.

Arama alanınıza bir tampon eklemek için geography parametresini geography_radius ile birlikte kullanabilirsiniz.

Minimum 40,0 metreye 40,0 metre (1.600 m2) arama alanı zorunludur. Bu sınırın altında bir arama alanı belirtirseniz işlev, geçersiz bağımsız değişken hatası döndürür.

 GEOGRAPHY Her tür GEOGRAPHY.
geographies

Yalnızca PLACES_COUNT_PER_GEO için

Aranacak alanların listesini belirtir. Point, LineString ve Polygon gibi her tür GEOGRAPHY desteklenir.

Arama alanınıza bir tampon eklemek için geographies parametresini geography_radius ile birlikte kullanabilirsiniz. Tampon, belirtilen tüm coğrafyalara eklenir.

Minimum 40,0 metreye 40,0 metre (1.600 m2) arama alanı zorunludur. Bu sınırın altında bir arama alanı belirtirseniz işlev, geçersiz bağımsız değişken hatası döndürür.

 ARRAY<GEOGRAPHY> Her tür GEOGRAPHY.
geography_radius

Belirtilen coğrafi bölgeye metre cinsinden bir yarıçap veya tampon ekler. Varsayılan değer 0'dır.

Belirtilen değer, minimum 40,0 metreye 40,0 metre (1.600 m2) bir arama alanı tanımlamalıdır. Örneğin, Point coğrafi bölge için minimum yarıçap 23 metredir.

 INT64 Minimum değer 0'dır.
h3_resolution

Yalnızca PLACES_COUNT_PER_H3 için

Yerler sayısını H3 hücrelerinde toplamak için kullanılan H3 çözünürlüğü.

 INT64 0 ile 11 arasında.
types

Dikkate alınacak yer türlerini belirtir.

Her yer, bir yer türü grubu (ör. "restaurant" ve "cafe") içerir. Hiçbir tür belirtilmezse sonuçta tüm yer türleri dikkate alınır.

 ARRAY<STRING>

Olası değerlerin tam listesi için Yer türleri başlıklı makaleyi inceleyin.

Örnek:

["restaurant", "cafe", "bar"]
primary_type

Dikkate alınacak birincil türleri belirtir.

Bir yerin yalnızca bir birincil türü olabilir. Bu tür, konumu en iyi tanımlayan türdür.

Birincil tür belirtilmezse sonuçta tüm birincil yer türleri dikkate alınır.

 ARRAY<STRING>

Olası değerlerin tam listesi için Yer türleri başlıklı makaleyi inceleyin.

Örnek:

["restaurant", "cafe", "bar"]
brand_ids

Yalnızca PLACES_COUNT_PER_H3, PLACES_COUNT_V2 ve PLACES_COUNT_PER_TYPE_V2 için

Dikkate alınacak marka kimliklerini belirtir.

Her yer, marka kimlikleriyle ilişkilendirilebilir. Hiçbir marka kimliği belirtilmezse sonuçta tüm markalar (ve markasız yerler) dikkate alınır.

Not: Marka verileri yalnızca belirli ülkelerde desteklenir. Şu anda: ABD, Kanada, Birleşik Krallık ve Avustralya.

 ARRAY<STRING>

Marka kimlikleri dizisi. Marka verileri hakkında daha fazla bilgi için Marka verilerini kullanarak sorgu yazma başlıklı makaleyi inceleyin.

Örnek:

["brand_001", "brand_002"]
min_rating Dikkate alınacak minimum yer puanını belirtir.

Yer puanı, kullanıcıların yerle ilgili yorumlarına dayanır ve 1,0 ile 5,0 arasında bir değer alır.

Bu aralığın dışında bir derecelendirme belirtirseniz işlev, geçersiz bağımsız değişken hatası döndürür.

 FLOAT 1,0 ile 5,0 arasında.
max_rating

Dikkate alınacak maksimum yer puanını belirtir.

Yer puanı, kullanıcıların yerle ilgili yorumlarına dayanır ve 1,0 ile 5,0 arasında bir değerdir.

Bu aralığın dışında bir derecelendirme belirtirseniz işlev, geçersiz bağımsız değişken hatası döndürür.

 FLOAT 1,0 ile 5,0 arasında.
min_user_rating_count

Dikkate alınacak minimum kullanıcı puanı sayısını belirtir.

Kullanıcı puanı sayısı, bir yerin aldığı toplam yorum sayısıdır.

Minimum değer 0'dır. 0'ın altında bir değer belirtirseniz işlev, geçersiz bağımsız değişken hatası döndürür.

 INT64 Minimum değer 0'dır.
max_user_rating_count

Dikkate alınacak maksimum kullanıcı puanı sayısını belirtir.

Kullanıcı puanı sayısı, bir yerin aldığı toplam yorum sayısıdır.

Minimum değer 0'dır. 0'ın altında bir değer belirtirseniz işlev, geçersiz bağımsız değişken hatası döndürür.

 INT64 Minimum değer 0'dır.
price_level

Dikkate alınacak fiyat seviyelerini belirtir.

Birden fazla fiyat seviyesi belirtebilirsiniz.

 ARRAY<STRING>

Desteklenen değerler:

"PRICE_LEVEL_FREE"

"PRICE_LEVEL_INEXPENSIVE"

"PRICE_LEVEL_MODERATE"

"PRICE_LEVEL_EXPENSIVE"

"PRICE_LEVEL_VERY_EXPENSIVE"

Örnek:

["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]
business_status Dikkate alınacak işletme durumunu belirtir. Birden fazla işletme durumu belirtebilirsiniz. ARRAY<STRING>

Desteklenen değerler:

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

"FUTURE_OPENING"

Örnek:

["OPERATIONAL","CLOSED_TEMPORARILY"]
takeout Paket servis sunan yerleri dikkate alır. BOOLEAN TRUE, FALSE
delivery Paket servis hizmeti sunan yerleri dikkate alır. BOOLEAN TRUE, FALSE
dine_in Restoranda yemek servisi sunan yerleri dikkate alır. BOOLEAN TRUE, FALSE
curbside_pickup Arabaya teslim alma hizmeti sunan yerleri dikkate alır. BOOLEAN TRUE, FALSE
reservable Rezervasyon yapılabilen yerleri düşünün. BOOLEAN TRUE, FALSE
outdoor_seating Açık havada oturma alanı sunan yerleri dikkate alır. BOOLEAN TRUE, FALSE
live_music Canlı müzik sunan yerleri dikkate alır. BOOLEAN TRUE, FALSE
allows_dogs Köpek kabul edilen yerleri düşünün. BOOLEAN TRUE, FALSE
restroom Tuvalet bulunan yerleri dikkate alır. BOOLEAN TRUE, FALSE
serves_breakfast Kahvaltı servisi yapan yerleri dikkate alır. BOOLEAN TRUE, FALSE
serves_lunch Öğle yemeği servisi yapan yerleri dikkate alır. BOOLEAN TRUE, FALSE
serves_dinner Akşam yemeği servisi yapan yerleri dikkate alır. BOOLEAN TRUE, FALSE
serves_beer Bira servisi yapılan yerleri dikkate alır. BOOLEAN TRUE, FALSE
serves_wine Şarap servisi yapılan yerleri dikkate alır. BOOLEAN TRUE, FALSE
serves_brunch Geç kahvaltı servisi yapan yerleri dikkate alır. BOOLEAN TRUE, FALSE
serves_vegetarian_food Vejetaryen yemek servisi yapan yerleri dikkate alır. BOOLEAN TRUE, FALSE
serves_cocktails Kokteyl servisi yapılan yerleri dikkate alır. BOOLEAN TRUE, FALSE
serves_dessert Tatlı servisi yapan yerleri dikkate alır. BOOLEAN TRUE, FALSE
serves_coffee Kahve servisi yapılan yerleri dikkate alır. BOOLEAN TRUE, FALSE
menu_for_children Çocuk menüsü sunan yerleri dikkate alır. BOOLEAN TRUE, FALSE
good_for_children Çocuklar için uygun yerleri düşünün. BOOLEAN TRUE, FALSE
good_for_groups Gruplar için uygun yerleri düşünün. BOOLEAN TRUE, FALSE
good_for_watching_sports Spor etkinliklerini izlemek için uygun olan yerleri düşünün. BOOLEAN TRUE, FALSE
accepts_credit_cards Kredi kartı kabul eden yerleri düşünün. BOOLEAN TRUE, FALSE
accepts_debit_cards Banka kartı kabul eden yerleri düşünün. BOOLEAN TRUE, FALSE
accepts_cash_only Yalnızca nakit kabul eden yerleri düşünün. BOOLEAN TRUE, FALSE
accepts_nfc NFC ile ödeme kabul eden yerleri değerlendirin. BOOLEAN TRUE, FALSE
free_parking_lot Ücretsiz otoparkı olan yerleri dikkate alır. BOOLEAN TRUE, FALSE
paid_parking_lot Ücretli otoparkı olan yerleri dikkate alır. BOOLEAN TRUE, FALSE
free_street_parking Cadde üzerinde ücretsiz park yeri olan yerleri dikkate alır. BOOLEAN TRUE, FALSE
paid_street_parking Cadde üzerinde ücretli park yeri olan yerleri dikkate alır. BOOLEAN TRUE, FALSE
valet_parking Vale park hizmeti sunan yerleri dikkate alır. BOOLEAN TRUE, FALSE
free_garage_parking Ücretsiz kapalı otoparkı olan yerleri dikkate alır. BOOLEAN TRUE, FALSE
paid_garage_parking Ücretli kapalı otoparkı olan yerleri dikkate alır. BOOLEAN TRUE, FALSE
wheelchair_accessible_parking Tekerlekli sandalye kullanıcılarına uygun park yeri olan yerleri dikkate alır. BOOLEAN TRUE, FALSE
wheelchair_accessible_entrance Tekerlekli sandalye kullanıcılarına uygun girişi olan yerleri dikkate alır. BOOLEAN TRUE, FALSE
wheelchair_accessible_restroom Tekerlekli sandalye kullanıcılarına uygun tuvaleti olan yerleri dikkate alır. BOOLEAN TRUE, FALSE
wheelchair_accessible_seating Tekerlekli sandalye kullanıcılarına uygun oturma düzeni olan yerleri dikkate alır. BOOLEAN TRUE, FALSE
snapshot_date

Sorgulanacak geçmiş anlık görüntü ayını belirtir.

Atlanırsa varsayılan olarak en son anlık görüntü kullanılır.

 STRING

Biçim: YYYY-MM.

Örnek: "2026-07"
month1

Yalnızca PLACES_COUNT_CHANGE için

Sorgulanacak referans anlık görüntü ayını belirtir.

 STRING

Biçim: YYYY-MM.

Örnek: "2026-01"
month2

Yalnızca PLACES_COUNT_CHANGE için

Sorgulanacak karşılaştırma anlık görüntüsünün ayını belirtir.

 STRING

Biçim: YYYY-MM.

Örnek: "2026-02"
regular_opening_hours

Yerleri normal çalışma saatlerine göre filtreler.

 JSON

Örnek: JSON_OBJECT('monday', [JSON_OBJECT('start_time', '09:00', 'end_time', '12:00')])
min_ev_charge_connector_count

Minimum elektrikli araç şarj konnektörü sayısını belirtir.

 INT64 Minimum değer 0'dır.
max_ev_charge_connector_count

Maksimum elektrikli araç şarj konnektörü sayısını belirtir.

 INT64 Minimum değer 0'dır.
max_ev_max_charge_rate_kw

Elektrikli araç şarj istasyonları için kW cinsinden maksimum şarj hızını belirtir.

 FLOAT64 Minimum değer 0,0'dır.
ev_charge_connector_types

Dikkate alınacak elektrikli araç konnektör türlerini belirtir.

 ARRAY<STRING>

Örnek: ["EV_CONNECTOR_TYPE_TESLA"]