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

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

בקטע הזה נסביר איך להעביר אפליקציה מהגרסה Preview לגרסה GA.

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

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

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

    • מחרוזות כתובות ("Chicago, IL" או "Darwin, NT, Australia")

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

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

    • Plus Codes

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

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

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

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