דף זה תורגם על ידי Cloud Translation API.

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

הגרסה הזו של 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 כדי להגדיר את סביבת הפיתוח שלכם לגישה לכרטיסי המוצר.
משתמשים קיימים: כדי לעבור לשימוש בדפי מוצר, צריך לפעול לפי השלבים הבאים

שלבים בהעברה

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

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

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

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

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

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

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

השאילתה הזו כוללת שם פרויקט ומשתמשת בשם מערך הנתונים 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";