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

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

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

תכונות חדשות שנוספו לגרסת GA

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

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

    • מחרוזות כתובת ("שיקגו, IL" או "Darwin, NT, Australia")

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

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

    • Plus Codes

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

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

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

עכשיו צריך להפעיל באופן מפורש את התכונות הבאות ב-GA על ידי הוספת שדה המערך החדש 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, כך שיכלול אחד או יותר מהערכים הבאים: