העברה מגרסת טרום-השקה (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 לבקשה:

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

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