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ımak amacıyla sağlanır. Örnek veri kümesi yalnızca şehrin kendisine ait 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. 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 ü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 Insights 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 dışındaki 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. Tek tek yerlerle ilgili ayrıntıları aramak için döndürülen yer kimlikleri gibi daha ayrıntılı analizler sunar. 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, Yer Kimlikleri listesi döndürebilir. Bu kimlikler, Places API ve Places UI Kit gibi diğer GMP ürünleri kullanılarak tek tek yer bilgilerini aramak için kullanılabilir.

Places Count 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, AVG, SUM veya COUNTIF gibi sayıların ötesinde analizler elde etmek istiyorsanız ya da veri kümelerini birleştirme gibi daha karmaşık sorgular gerçekleştirmeniz gerekiyorsa verileri doğrudan sorgulayın.

Sonuç sayısının az olup olmadığını veya hiç sonuç olmadığını bilmeniz 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ın ayrıntılı bir karşılaştırması verilmektedir.

Yerler 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 değildir.
  • 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şlev için 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, doğrudan sorgu özelliği filtreleriyle aynıdır. Ancak aşağıdaki özellikler farklıdır:
  • Yer id
  • Adres bileşenleri
  • Çalışma saatleri
  • EV şarjı seçenekleri
  • Markalar
Tam şema desteklenir.