מדריך להעברת נתונים (מיגרציה)

הגרסה הזו של Places Insights, שתצא ב-4 בספטמבר 2025, כוללת את השינויים הבאים מהגרסה הראשונית:

  • אפשר להירשם למינוי של תובנות לגבי מקומות במיקום ב-BigQuery לפי בחירתכם.

  • העברת מערכי הנתונים של Places Insights ממרכזי נתונים נקיים אל רשימות של נתונים ב-BigQuery.

  • שדות הכתובת בסכימת מערך הנתונים מפרידים בין השדות id ו-name לשדות נפרדים של מחרוזת או מערך מחרוזות.

מעבר לכרטיסי מוצר

בגרסת התצוגה המקדימה הראשונית של Places Insights, הנתונים נפרסו בחדרי נתונים ב-BigQuery. בגרסה מ-4 בספטמבר 2025, העברנו את מערכי הנתונים אל הכרטיסיות ב-BigQuery כדי לאפשר לכם להירשם למערך הנתונים באזור ספציפי ב-BigQuery. לשינוי הזה אין השפעה על תכונות המוצר ועל השימושיות של 'תובנות לגבי מקומות'.

כדי להירשם ל-Places Insights באזור מסוים, צריך להירשם לרישומים החדשים ב-BigQuery Sharing. אחרי שנרשמים למינוי של הנתונים החדשים, לא צריך לשנות את שאילתות ה-SQL. הן ימשיכו לפעול באותו אופן.

  • משתמשים חדשים: אם אתם משתמשים חדשים ב-Places Insights, אתם צריכים לפעול לפי השלבים במאמר הגדרת Places Insights כדי להגדיר את סביבת הפיתוח שלכם לגישה לכרטיסי המוצר.

  • משתמשים קיימים: כדי לעבור לשימוש בכרטיסי מוצר, צריך לפעול לפי השלבים הבאים

שלבים בהעברה

כדי לעבור לכרטיסי מוצר, צריך:

  1. נרשמים לכרטיסי המוצר של העיר והמדינה הרצויות. הוראות מפורטות מופיעות במאמר בנושא הגדרת תובנות לגבי מקומות.

  2. מעדכנים את שם מערך הנתונים בשאילתות או בפונקציות לשם מערך הנתונים שבחרתם למעלה.

  3. אם השתמשתם בעבר בפונקציות, צריך להסיר את שם הפרויקט שבו השתמשתם עם מרכזי נתונים מאובטחים (maps-platform-analytics-hub).

  4. משנים את השאילתות או הפונקציות הקיימות כך שיכללו את שם הפרויקט (אופציונלי) ואת שדות הכתובת החדשים.

אפשר לכלול את שם הפרויקט כשמפנים לכרטיס (אופציונלי)

כשמשתמשים בפירוט, אפשר לכלול את שם הפרויקט בשאילתה. אם לא מציינים שם פרויקט, השאילתה תוגדר כברירת מחדל לפרויקט הפעיל.

כדאי לכלול את שם הפרויקט אם קישרתם מערכי נתונים עם אותו שם בפרויקטים שונים, או אם אתם שולחים שאילתה לטבלה מחוץ לפרויקט הפעיל.

דוגמה לשאילתה מעודכנת עם שם הפרויקט ושם מערך הנתונים

השאילתה הזו כוללת שם פרויקט ומשתמשת בשם מערך הנתונים my_dataset_name:

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

מעבר לשדות הכתובת החדשים

בגרסה הראשונית של Places Insights, סכימת מערך הנתונים ייצגה שדה כתובת כ-STRUCT או כ-RECORD שמכילים שדה משנה id ושדה משנה name. בגרסה הזו, הסכימה היא שטוחה, כלומר מוגדרים שדות נפרדים ברמה העליונה עבור id ו-name. השדות החדשים הם שדות של מחרוזות או של מערכי מחרוזות.

לדוגמה, הסכימה של רכיב הכתובת של המקום בגרסה הראשונית מוצגת בהמשך:

locality STRUCT
  locality.id STRING
  locality.name STRING

בגרסה הזו, קבוצת הנתונים מכילה עכשיו שני שדות של מערך מחרוזות ברמה העליונה. לדוגמה, הסכימה המעודכנת של נתוני המיקום מוצגת בהמשך:

locality_ids ARRAY<string>
locality_names ARRAY<string>

לעיון במפרט המלא

שדות שהם לא מערך

בגרסה הזו, השדות id ו-name הם עכשיו שדות STRING ברמה העליונה בשביל שדות כתובת שאינם מערך:

administrative_area_level_1_id STRING
administrative_area_level_1_name STRING

הפורמט החדש הזה חל על כל השדות בטופס administrative_area_level_N, כאשר N הוא מספר בין 1 ל-7.

דוגמה לשימוש בשדות חדשים

בגרסה הראשונית של 'תובנות לגבי מקומות', השתמשתם בשדה administrative_area_level_1.name בסעיף WHERE כדי לסנן את התוצאות:

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

עם השדות החדשים, כותבים את השאילתה באמצעות השדה 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";