Taşıma rehberi

Places Insights'ın 4 Eylül 2025 tarihli bu sürümünde, ilk sürüme kıyasla aşağıdaki değişiklikler yapılmıştır:

  • İstediğiniz BigQuery konumunda Yer Analizleri'ne abone olma özelliğini destekler.
  • Places Insights veri kümelerini veri temizleme odalarından BigQuery veri borsası listelemelerine taşır.

  • Veri kümesi şemasındaki adres alanları, id ve name alanlarını ayrı dize veya dize dizisi alanlarına ayırır.

Listelemelere taşıma

Places Insights'ın ilk önizleme sürümünde, BigQuery'deki veri temizleme odalarına veri dağıtıldı. 4 Eylül 2025'te yayınlanan sürümle birlikte, veri kümelerini BigQuery listelemelerine taşıdık. Bu sayede, belirli bir BigQuery bölgesindeki veri kümesine abone olabilirsiniz. Bu değişikliğin, Places Insights'ın ürün özellikleri ve kullanılabilirliği üzerinde herhangi bir etkisi yoktur.

Belirli bir bölgede Places Insights'a abone olmak için BigQuery Sharing'deki yeni listelere abone olmanız gerekir. Yeni listelere abone olduktan sonra SQL sorgularınızı değiştirmeniz gerekmez. Bu uygulamalar aynı şekilde çalışmaya devam eder.

  • Yeni kullanıcılar: Places Insights'ı yeni kullanmaya başladıysanız listelere erişmek için geliştirme ortamınızı yapılandırmak üzere Places Insights'ı ayarlama bölümündeki adımları uygulayın.

  • Mevcut kullanıcılar: Listelemeleri kullanmaya geçmek için aşağıdaki adımları uygulayın.

Taşıma adımları

Listelemelere geçmek için yapmanız gerekenler:

  1. Seçtiğiniz şehir ve ülkedeki listelemelere abone olun. Talimatlar için Places Insights'ı ayarlama başlıklı makaleyi inceleyin.

  2. Sorgularınızdaki veya işlevlerinizdeki veri kümesi adını, yukarıda seçtiğiniz veri kümesi adıyla güncelleyin.

  3. Daha önce işlevleri kullandıysanız veri temizleme odalarıyla kullanılan proje adını kaldırın (maps-platform-analytics-hub).

  4. Proje adınızı (isteğe bağlı) ve yeni adres alanlarını içerecek şekilde mevcut sorgularınızı veya işlevlerinizi değiştirin.

Listelemeye referans verirken proje adınızı ekleyin (isteğe bağlı).

Listelemelerle, sorguya proje adınızı ekleyebilirsiniz. Proje adı belirtmezseniz sorgunuz varsayılan olarak etkin projeye yönlendirilir.

Farklı projelerde aynı ada sahip veri kümelerini bağladıysanız veya etkin proje dışındaki bir tabloya sorgu gönderiyorsanız proje adınızı eklemek isteyebilirsiniz.

Proje ve veri kümesi adıyla güncellenen sorgu örneği

Bu sorgu bir proje adı içerir ve my_dataset_name veri kümesi adını kullanır:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.my_dataset_name.places`

Yeni adres alanlarına geçiş yapma

Places Insights'ın ilk sürümünde, veri kümesi şeması bir adres alanını STRUCT veya RECORD olarak temsil ediyordu. Bu alanlar, id ve name alt alanını içeriyordu. Bu sürümde, id ve name için ayrı üst düzey alanlar tanımlamak üzere şema düzleştirilir. Yeni alanlar dize veya dize dizisi alanlarıdır.

Örneğin, ilk sürüm için yerleşim yeri adresi bileşeninin şeması aşağıda gösterilmektedir:

locality STRUCT
  locality.id STRING
  locality.name STRING

Bu sürümde veri kümesi artık iki üst düzey dize dizisi alanı içeriyor. Örneğin, güncellenen yerleşim yeri verileri şeması aşağıda gösterilmektedir:

locality_ids ARRAY<string>
locality_names ARRAY<string>

Şema referansının tamamını inceleyin.

Dizi olmayan alanlar

Bu sürümde, dizi olmayan adres alanları için id ve name alanları artık üst düzey STRING alanlarıdır:

administrative_area_level_1_id STRING
administrative_area_level_1_name STRING

Bu yeni biçim, formdaki tüm alanlar için geçerlidir administrative_area_level_N. Burada N, 1 ile 7 arasındadır.

Yeni alanların kullanıldığı örnek

Places Insights'ın ilk sürümünde, sonuçları filtrelemek için WHERE ifadesinde administrative_area_level_1.name alanını kullanıyordunuz:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1.name = "New York";

Yeni alanlarla sorguyu administrative_area_level_1_name alanını kullanarak yazarsınız:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1_name = "New York";