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

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

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

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

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

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

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

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

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

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

    • Plus Codes

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

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

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

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

בגרסת ה-Preview, השתמשתם ב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(Traffic on a polyline)

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

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