Places Insights verileri ve sorguları hakkında

Places Insights verileri

Places Insights, BigQuery'de tam ve örnek veri kümeleri sağlar.

Örnek veri kümeleri, Places Insights'ı denemenize olanak tanır. Böylece, tam veri kümesini satın almaya karar vermeden önce ürünün kullanılabilirliğini ve değerini değerlendirebilirsiniz. Örnek veri kümesi yalnızca şehrin kendisine ait verileri içerir. Çevredeki metropol alanıyla ilgili verileri içermez.

Örnek girişte, desteklenen her ülkenin en önemli şehirlerinden biriyle ilgili veriler yer alır:

Amsterdam (NL) Helsinki (FI) Filibe (BG)
Ankara (TR) Hong Kong (HK) Riffa (BH)
Arequipa (PE) Cakarta (ID) Roma (IT)
Atina (GR) Cidde (SA) Santiago (CL)
Bad Gastein (AT) Johannesburg (ZA) Sao Paulo (BR)
Berlin (DE) Kuala Lumpur (MY) Şarika (AE)
Brno (CZ) Lizbon (PT) Singapur (SG)
Brüksel (BE) Londra (GB) Stockholm (SE)
Bükreş (RO) Lusail (QA) Sidney (AU)
Buenos Aires (AR) Madrid (ES) Taipei (TW)
Busan (KR) Manila (PH) Tel Aviv-Yafo (IL)
Kahire (EG) Medellín (CO) Tokyo (JP)
Chiang Mai (TH) Mexico City (MX) Toronto (CA)
Kopenhag (DK) Mumbai (IN) Varşova (PL)
Cork (IE) New York (ABD) Wellington (NZ)
Debrecen (HU) Oslo (NO) Zürih (CH)
Hanoi (VN) Paris (FR)

Tam veri kümeleri, desteklenen her ülkeye ait verileri içerir ve satın alınması gerekir. Places Insights'a kaydolmak istiyorsanız istek formunu doldurun. Yalnızca veri abonesinin Places Insights veri kümesine erişim isteğinde bulunması gerekir. Abonelik bir BigQuery projesinde etkinleştirildikten sonra, bu projeye erişimi olan tüm kullanıcılar Places Insights verilerini sorgulayabilir.

Her ülke veri kümesinin ayrı ayrı abone olmanız gereken kendi girişi vardır. Bir girişe abone olma hakkında daha fazla bilgi için Places Insights'ı ayarlama başlıklı makaleyi inceleyin.

Veri kümesi şemaları

Her ülke için yerler veri kümesi şeması iki bölümden oluşur:

Örneğin, İspanya (ES) veri kümesiyle çalışıyorsanız hem temel şemaya hem de ES'ye özgü şemaya bakın.

Markalar veri kümesinin şeması üç alan tanımlar:

  • id: Marka kimliği.
  • name: Markanın adı (ör. "Hertz" veya "Chase").
  • category: Markanın "Benzin İstasyonu", "Yiyecek ve İçecek" veya "Konaklama" gibi üst düzey kategorisi.

Places Insights verilerini sorgulama

Places Insights, veri kümelerini sorgulamak için iki yöntem sunar:

  • Veri kümesini doğrudan SQL kullanarak sorgulama: Veri kümesi tablolarında standart BigQuery SQL sorguları yürütün. Bu sayede karmaşık filtreleme, kendi verilerinizle birleştirme, özel analiz ve COUNT dışında ek toplama işlevleri (ör. AVG, SUM ve GROUP BY) için en yüksek esneklik sağlanır. Belgeleri inceleyin.
  • Places Count işlevlerini kullanarak veri kümesini sorgulama: Places Count işlevleri, doğrudan BigQuery'de çalışan ve yaygın veri alma görevlerini basitleştiren önceden tanımlanmış, optimize edilmiş SQL sorgularıdır. Bu API'ler, belirli yerlerle ilgili ayrıntıları aramak için yer kimliklerini döndürmek gibi daha ayrıntılı analizler sağlar. Belgeleri inceleyin.

Doğrudan sorgular

Verileri doğrudan sorgulamak, bir toplama eşiği uygular. Yalnızca sorgu en az 5 yer topluyorsa sonuç döndürülür. Örneğin, arama ölçütlerinizin sonucu 0, 1, 2, 3 veya 4 ise sonuç yanıttan çıkarılır. Örneğin, belirli bir bölgedeki toplam restoran sayısını öğrenmek için yapılan bir sorgu, yalnızca toplam sayı 5 veya daha yüksekse yanıt döndürür. Aksi takdirde yanıt döndürülmez.

Yer Sayısı işlevi sorguları

Places Count işlevleri, Places API ve Places UI Kit gibi diğer GMP ürünlerini kullanarak tek tek yer bilgilerini aramak için kullanılabilecek yer kimliklerinin listesini döndürebilir.

Yer Sayısı işlevleri, toplama eşiği uygulamaz.Bunun yerine, minimum 40,0 metreye 40,0 metre (1.600 m2) arama alanı uygular. Yani arama sorgunuz minimum arama alanından büyük olduğu sürece, sorgunuzla eşleşen 0 yer olsa bile her zaman bir sonuç alırsınız.

Verileri doğrudan sorgulama ve işlevleri kullanma zamanı

Düşük sonuç sayılarına ihtiyacınız yoksa, sayıların ötesinde analizler (ör. AVG, SUM veya COUNTIF) almak istiyorsanız ya da veri kümelerini birleştirme gibi daha karmaşık sorgular yapmanız gerekiyorsa verileri doğrudan sorgulayın.

Az sayıda sonuç olup olmadığını veya hiç sonuç olmadığını öğrenmeniz gerekiyorsa ya da yer adı veya adres gibi bireysel yer bilgilerini almanız gerekiyorsa işlevleri kullanarak sorgu yapın.

Bu tabloda, doğrudan sorgular ile Places Count işlevleri arasındaki farkların ayrıntılı bir karşılaştırması sunulmaktadır.

Places Count işlevleri Doğrudan veri kümesi sorguları
Avantajlar
  • Diğer API'leri sorgulamak için kullanılabilecek yer kimliklerini döndürür.
  • Herhangi bir sayı döndürebilir.
  • Performans ve düşük işlem maliyeti için optimize edilmiştir.
  • Kullanımı basittir. Karmaşık sorgular yazmanıza gerek yoktur.
  • Giriş parametrelerini doğrular ve hata döndürerek kullanımı ve hata ayıklamayı kolaylaştırır.
  • Gelişmiş filtreleme ve birleştirme gibi karmaşık sorgulara olanak tanır.
  • Minimum arama alanı zorunlu tutulmaz.
  • COUNT dışında AVG, SUM ve GROUP BY gibi ek toplama işlevlerini destekler.
Arayüz COUNT analizleri oluşturan önceden tanımlanmış dört SQL işlevi: tek sayı, türe göre sayı, coğrafyaya göre sayı, H3 hücresine göre sayı. JSON_OBJECT, işleve bağımsız değişkenler iletir. COUNT, COUNT_IF, SUM ve AVG. gibi toplama işlevlerini çalıştırmak için kendi SQL'inizi yazın. JOIN, GROUP BY, WHERE ve diğerlerini kullanarak ek analizler oluşturabilirsiniz.
Kısıtlamalar Minimum 40,0 metreye 40,0 metre (1.600 m2) arama alanı zorunlu kılar. Minimum arama alanı karşılandığı sürece, toplama sayısı 5'ten az olsa bile işlev bir sonuç döndürür. Sayıları 5'ten az olan sonuçlar, sonuçlardan çıkarılır (yani satır hariç tutulur).
Desteklenen özellik filtreleri Yer Sayısı işlevi filtre parametreleri, aşağıdakiler hariç olmak üzere doğrudan sorgu özelliği filtreleriyle aynı özellikleri destekler:
  • Yer id
  • Adres bileşenleri
Tam şema desteklenir.