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, tam veri kümesini satın alma kararı vermeden önce ürünün kullanılabilirliğini ve değerini değerlendirebilmeniz için Places Insights'ı denemenize olanak tanımayı amaçlamaktadır. Örnek veri kümesi yalnızca şehrin kendisiyle ilgili verileri içerir. Çevredeki metropol alanına ait verileri içermez.

Örnek girişte, desteklenen ülkelerin her biri için en iyi şehirlerin verileri yer alır: Sidney (AU), Sao Paulo (BR), Toronto (CA), Zürih (CH), Berlin (DE), Madrid (ES), Paris (FR), Londra (UK), Cakarta (ID), Mumbai (IN), Roma (IT), Tokyo (JP), Mexico City (MX), New York City (US).

Tam veri kümeleri, desteklenen her ülkeye ait verileri içerir ve satın alınması gerekir. Veri kümesinin tamamını satın almak istiyorsanız istek formunu doldurun. Places Insights veri kümesine erişim isteğinde bulunması gereken tek kişi veri abonesidir. BigQuery projesinde abonelik etkinleştirildikten sonra, bu projeye erişimi olan tüm kullanıcılar Places Insights verilerini sorgulayabilir.

Her ülke veri kümesinin ayrı bir girişi vardır ve bu girişlere ayrı ayrı abone olmanız gerekir. Listeye abone olma hakkında daha fazla bilgi için Places Insights'ı ayarlama başlıklı makaleyi inceleyin.

Veri kümesi şemaları

Her ülkenin 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 referans verin.

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

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

Places Analizleri verilerini sorgulama

Places Insights, veri kümelerini sorgulamanın iki yolunu sunar:

  • SQL kullanarak veri kümesini doğrudan sorgulama: Veri kümesi tablolarına karşı standart BigQuery SQL sorguları yürütün. Bu, karmaşık filtreleme, kendi verilerinizle birleştirme, özel analiz ve COUNT'nın ötesinde ek toplama işlevleri (ör. AVG, SUM ve GROUP BY) için en fazla esnekliği sağlar. Belgeleri inceleyin.
  • Yer Sayısı işlevlerini kullanarak veri kümesini sorgulama: Yer Sayısı 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. Bunlar, tek tek yerlerle ilgili ayrıntıları aramak için yer kimliklerini döndürme gibi daha ayrıntılı analizler sağlar. Belgelere göz atın.

Doğrudan sorgular

Verilerin doğrudan sorgulanması, toplama eşiğini zorunlu kılar. 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ı sorgusu yalnızca toplam sayı 5 veya daha yüksekse yanıt döndürür, aksi takdirde yanıt döndürülmez.

Places Count işlevi sorguları

Yer Sayısı işlevleri, Places API ve Places UI Kit gibi diğer GMP ürünleri kullanılarak tek tek yer bilgilerini aramak için kullanılabilecek bir Yer Kimliği listesi döndürebilir.

Yer Sayısı işlevleri, bir toplama eşiği zorunlu kılmaz ancak bunun yerine 40,0 metreye 40,0 metre (1.600 m2) boyutlarında minimum bir arama alanı zorunlu kılar. Bu, arama sorgunuz minimum arama alanından büyük olduğu sürece, sorgunuzla eşleşen yer olmasa bile her zaman sonuç alacağınız anlamına gelir.

Verilere doğrudan ne zaman sorgu gönderilir ve işlevler ne zaman kullanılır?

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

Sonuç sayısının az olup olmadığını veya hiç sonuç olmadığını öğrenmeniz ya da yer adı veya adres gibi tek tek yer bilgilerini almanız gerekiyorsa işlevleri kullanarak sorgu gönderin.

Bu tabloda, doğrudan sorgular ve yer sayısı işlevleri arasındaki farklar ayrıntılı olarak karşılaştırılmaktadır.

Yer sayısı 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şleme 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 kullanmayı 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 dört önceden tanımlanmış SQL işlevi: tek sayı, türe göre sayı, coğrafyaya göre sayı, H3 hücresine göre sayı. JSON_OBJECT, işlevlere 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ğerleri kullanılarak ek analizler oluşturulabilir.
Kısıtlamalar 40,0 metreye 40,0 metre (1.600 m2) boyutlarında minimum arama alanı zorunlu kılar. Minimum arama alanı karşılandığı sürece, toplama sayısı 5'ten az olsa bile bir işlev sonuç döndürür. Sayıları 5'ten az olan sonuçlar, sonuçlardan çıkarılır (ör. satır hariç tutulur).
Desteklenen özellik filtreleri Places Count işlevi filtre parametreleri, aşağıdakiler hariç doğrudan sorgu özelliği filtreleriyle aynı şekilde desteklenir:
  • Yer id
  • Adres bileşenleri
  • Çalışma saatleri
  • EV şarjı seçenekleri
  • Markalar
Tam şema desteklenir.