Panduan migrasi

Rilis Places Insight pada 4 September 2025 ini mencakup perubahan berikut dari rilis awal:

  • Mendukung kemampuan untuk berlangganan Places Insights di lokasi BigQuery pilihan Anda.

  • Memindahkan set data Places Insights dari ruang bersih data ke listingan pertukaran data BigQuery.

  • Kolom alamat dalam skema set data memisahkan kolom id dan name menjadi kolom string atau array string diskrit.

Bermigrasi ke listingan

Rilis Pratinjau awal Places Insights men-deploy data di ruang bersih data BigQuery. Dengan rilis 4 September 2025, kami memindahkan set data ke listingan BigQuery untuk memungkinkan Anda berlangganan set data di region BigQuery tertentu. Perubahan ini tidak memengaruhi fitur produk dan kegunaan Places Insights.

Untuk berlangganan Insight Tempat di wilayah tertentu, Anda harus berlangganan listingan baru di BigQuery Sharing. Setelah berlangganan listingan baru, Anda tidak perlu mengubah kueri SQL. Keduanya akan tetap berfungsi sama.

  • Pengguna baru: Jika Anda adalah pengguna baru Places Insight, ikuti langkah-langkah di Menyiapkan Places Insight untuk mengonfigurasi lingkungan pengembangan Anda untuk mengakses listingan.

  • Pengguna lama: Ikuti langkah-langkah di bawah untuk bermigrasi ke penggunaan listingan

Langkah migrasi

Untuk bermigrasi ke listingan, Anda harus:

  1. Berlangganan listingan untuk kota dan negara pilihan Anda. Untuk petunjuknya, lihat Menyiapkan Insight Tempat.

  2. Perbarui nama set data dalam kueri atau fungsi Anda ke nama set data yang Anda pilih di atas.

  3. Jika sebelumnya Anda menggunakan fungsi, hapus nama project yang digunakan dengan ruang bersih data (maps-platform-analytics-hub).

  4. Ubah kueri atau fungsi yang ada untuk menyertakan nama project Anda (opsional) dan kolom alamat baru.

Sertakan nama project Anda saat mereferensikan listingan (opsional)

Dengan listingan, Anda dapat menyertakan nama project dalam kueri. Jika Anda tidak menentukan nama project, kueri Anda akan ditetapkan secara default ke project aktif.

Anda mungkin ingin menyertakan nama project jika telah menautkan set data dengan nama yang sama dalam project yang berbeda, atau jika Anda membuat kueri tabel di luar project aktif.

Contoh kueri yang diperbarui dengan nama project dan set data

Kueri ini menyertakan nama project dan menggunakan nama set data my_dataset_name:

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

Bermigrasi ke kolom alamat baru

Pada rilis awal Places Insights, skema set data merepresentasikan kolom alamat sebagai STRUCT atau RECORD yang berisi subkolom id dan name. Rilis ini meratakan skema untuk menentukan kolom tingkat teratas yang terpisah untuk id dan name. Kolom baru ini berupa kolom string atau array string.

Misalnya, skema untuk komponen alamat lokalitas untuk rilis awal ditampilkan di bawah:

locality STRUCT
  locality.id STRING
  locality.name STRING

Dalam rilis ini, set data kini berisi dua kolom array string tingkat atas. Misalnya, skema data lokalitas yang diperbarui ditampilkan di bawah:

locality_ids ARRAY<string>
locality_names ARRAY<string>

Lihat referensi skema lengkap.

Kolom non-array

Dalam rilis ini, kolom id dan name kini menjadi kolom STRING tingkat teratas untuk kolom alamat non-array:

administrative_area_level_1_id STRING
administrative_area_level_1_name STRING

Format baru ini berlaku untuk semua kolom dalam formulir administrative_area_level_N, dengan N adalah 1 hingga 7.

Contoh menggunakan kolom baru

Pada rilis awal Places Insights, Anda menggunakan kolom administrative_area_level_1.name dalam klausa WHERE untuk memfilter hasil:

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

Dengan kolom baru, Anda menulis kueri menggunakan kolom administrative_area_level_1_name:

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