העברה מגרסת טרום-השקה (Preview)

בספטמבר 2022 הושק ה-Routes API כגרסת טרום-GA ציבורית (גרסת טרום-GA). מוצרים במצב טרום-GA מכוסים על ידי התנאים הספציפיים לשירות של הפלטפורמה של מפות Google. מידע נוסף זמין בתיאורים של שלבי ההשקה.

בקטע הזה מוסבר איך להעביר אפליקציה מגרסת טרום-השקה (Preview) לגרסת Google Analytics.

תכונות חדשות נוספו לגרסה של Google Analytics

בגרסת GA מתווספות התכונות החדשות הבאות שלא נכללו בתצוגה המקדימה:

• יחד עם מזהי מקומות וקואורדינטות של קווי אורך ורוחב, מעכשיו תוכלו לציין מיקום בגרסה של Google Analytics באמצעות:

  • מחרוזות כתובת ("שיקגו, אילינוי" או "דרווין, NT, אוסטרליה")

    מחרוזות כתובת הן בדרך כלל האופן שבו משתמש מזין כתובת. עם זאת, {product_name} צריך תחילה לבצע קידוד גיאוגרפי של מחרוזת הכתובת באופן פנימי כדי להמיר אותה לקואורדינטות של קווי אורך ורוחב, כדי שניתן יהיה לחשב את המסלול.

    בנוסף, נוספה תמיכה בפרמטר הבקשה regionCode, וכך אתם יכולים לציין איך להציג תוצאות מקודדות גיאוגרפיות עבור אזור גיאוגרפי ספציפי.

  • קודי Plus

    קודי OLC דומים לרחובות של אנשים או מקומות שאין להם כתובת ממשית. במקום כתובות עם שמות רחובות ומספרים, קודי Plus Code מבוססים על קווי רוחב ואורך, ומוצגים כמספרים ובאותיות.

• התשובה של נתיבי המחשוב מכילה עכשיו את המערך geocodingResults. לכל מיקום בבקשה (מקור, יעד או ציון ביניים ברמת הביניים) שצוין כמחרוזת כתובת או כ-Plus code, ה-API מחפש מזהה מקום. כל רכיב במערך הזה מכיל את מזהה המקום שתואם למיקום מסוים, וגם מטא-נתונים נוספים לגבי אותו מיקום. המערכת מתעלמת ממיקומים בבקשה שצוינו כמזהה מקום או כקואורדינטות של קו רוחב/אורך.

שינויים בתכונות קיימות של תצוגה מקדימה

עכשיו צריך להפעיל באופן מפורש את התכונות הבאות ב-Google Analytics, על ידי הוספת השדה החדש המערך extraComputations לבקשה:

• פרטי כבישי אגרה

• צריכת דלק

• תנועה בקו פוליגוני

בגרסת טרום-ההשקה (Preview), השתמשתם במסכת שדות כדי לציין בתגובה מידע על התכונות האלה. עכשיו תצטרכו:

• כדי להפעיל את התכונות האלה, צריך להגדיר את הפרמטר החדש של בקשת המערך extraComputations.
• צריך להגדיר אנונימיזציה של שדות כדי לציין להחזרת המידע בתגובה.

מה חשוב לדעת?

השדות הבאים לא ייכללו יותר בתגובות של computeRouteMatrix, אלא אם הופעלו באופן מפורש על ידי ההגדרה extraComputations:

• travelAdvisory.tollInfo (פרטי כביש האגרה)

השדות הבאים לא ייכללו יותר בתגובות של computeRoutes, אלא אם הופעלו באופן מפורש על ידי ההגדרה extraComputations:

• routes.legs.travelAdvisory.tollInfo(פרטי כביש האגרה)
• routes.travelAdvisory.tollInfo(פרטי כביש האגרה)
• routes.travelAdvisory.fuelConsumptionMicroliters(צריכת דלק)
• routes.travelAdvisory.speedReadingIntervals(תנועה בקו פוליגון)
• routes.legs.travelAdvisory.speedReadingIntervals(תנועה בקו פוליגון)

מה עליי לעשות?

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

• כדי לקבל את פרטי האגרה, צריך להגדיר את השדה החדש של מערך extraComputations לערך "TOLLS".

• כדי לקבל את צריכת הדלק, צריך להגדיר את שדה המערך extraComputations החדש כ-"FUEL_CONSUMPTION".

• כדי לקבל מידע על תנועה בקווים מרובים, צריך להגדיר את השדה החדש של מערך extraComputations ל-"TRAFFIC_ON_POLYLINE".