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

מפתחים באזור הכלכלי האירופי (EEA)

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

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

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

בגרסת ה-GA נוספו התכונות החדשות הבאות, שלא נכללו בגרסת ה-Preview:

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

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

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

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

    • קודי פלוס

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

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

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

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

בגרסת בטא, השתמשתם בfield mask כדי לציין להחזיר מידע על התכונות האלה בתשובה. עכשיו אתם צריכים:

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

מה חשוב לדעת?

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

  • travelAdvisory.tollInfo (פרטי שיחת חינם)

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

  • routes.legs.travelAdvisory.tollInfo(פרטי אגרה)
  • routes.travelAdvisory.tollInfo(מידע על שיחות בתשלום)
  • routes.travelAdvisory.fuelConsumptionMicroliters(צריכת דלק)
  • ‫routes.travelAdvisory.speedReadingIntervals(Traffic on a polyline)
  • routes.legs.travelAdvisory.speedReadingIntervals(תנועה בקו פוליגוני)

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

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