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 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 almaktadı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. Belgelere göz atın.
  • 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.

Yer sayısı 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 Kimlikleri listesi döndürebilir.

Yer sayısı işlevleri, bir toplama eşiği zorunlu kılmaz.Bunun yerine, 40,0 metreye 40,0 metre (1.600 m2) boyutunda 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 çalıştırmanız 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.

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 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 Yer sayısı işlevi filtre parametreleri, aşağıdakiler hariç doğrudan sorgu özelliği filtreleriyle aynıdır:
  • Yer id
  • Adres bileşenleri
  • Çalışma saatleri
  • EV şarjı seçenekleri
  • Markalar
Tam şema desteklenir.