למה כדאי לעבור ל-Routes API?

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

‫Routes API מספק ביצועים משופרים לחישוב מסלולים, מרחקים וזמני נסיעה, ולכן כדאי להחליף אפליקציות שמשתמשות ב-Directions API וב-Distance Matrix API. רוב הפונקציונליות של Routes API תואמת לדור הקודם של Directions API ושל Distance Matrix API.

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

שיפורים עיקריים

בקטע הזה נסביר על חלק מהשיפורים שצפויים לכם כשמשתמשים ב-Routes API באפליקציות.

מגבלות מוגדלות על בקשות

‫Routes API Compute Route Matrix
  • מקסימום 625 רכיבים, אלא אם מציינים TRAFFIC_AWARE_OPTIMAL.
  • מקסימום 100 רכיבים עם TRAFFIC_AWARE_OPTIMAL. העדפות מתקדמות לניתוב שיחות
  • עד 50 נקודות ציון (מקורות + יעדים) באמצעות מזהה מקום.
Distance Matrix API
  • כל בקשה יכולה לכלול מקסימום 25 מקורות או 25 יעדים.
  • עד 100 רכיבים (מספר המקורות × מספר היעדים) לכל בקשה בצד השרת.

תשובות מהירות יותר לבקשות

התכונה Compute Route Matrix (חישוב מטריצת נתיבים) מציעה את השיפורים הבאים בחביון:

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

שיפורים בניווט

התכונה 'חישוב מסלול' מציעה את שיפורי הניתוב הבאים:

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

בקשת גישה רק לנתונים שאתם צריכים

מעכשיו אפשר לציין אילו שדות להחזיר, וכך לקצר את זמן העיבוד ולהפחית את עלויות החיוב.

‫Routes API
Compute Routes
Compute Route Matrix 		בבקשות צריך להשתמש במסכת שדות כדי לציין אילו שדות רוצים להחזיר בתגובה. הסתרת שדות מבטיחה שלא תבקשו נתונים מיותרים, וכך תחסכו זמן עיבוד מיותר וחיובים מיותרים.
מידע נוסף זמין במאמר בנושא בחירת השדות שיוחזרו.
‫Directions API
‫Distance Matrix API 		הפונקציה מחזירה רשימת שדות שמוגדרת כברירת מחדל, גם אם האפליקציה לא צריכה אותם באופן מובהק. הדבר עלול לגרום לזמן עיבוד מיותר ולחיובים.

חישובים משופרים של מסלולים לתנועה

‫Routes API תומך בשלוש העדפות ניתוב שבהן אפשר להשתמש כדי לאזן בין זמן האחזור של התשובה לבין איכות הנתונים כשמבקשים מידע על תנועת הגולשים.

למידע נוסף, ראו הגדרת האיכות לעומת זמן האחזור.

‫TRAFFIC_UNAWARE
(ברירת מחדל)		 האפליקציה משתמשת בנתוני תנועה ממוצעים שלא תלויים בזמן, ולא בנתוני תנועה בזמן אמת, כדי לחשב את המסלול, וכך מתקבל זמן האחזור הנמוך ביותר בתגובה. ההגדרה הזו מקבילה למצב שבו לא נעשה שימוש בנתוני תנועה ב-Directions API וב-Distance Matrix API.
‫TRAFFIC_AWARE
(חדש)		 איכות תנועה בזמן אמת שעברה אופטימיזציה לביצועים כדי להפחית את זמן האחזור. בניגוד להגדרה TRAFFIC_AWARE_OPTIMAL, ההגדרה הזו מבצעת אופטימיזציות כדי להפחית באופן משמעותי את זמן האחזור. ההגדרה הזו חדשה גם ב-Routes API, ואין לה מקבילה ב-Directions API או ב-Distance Matrix API.
TRAFFIC_AWARE_OPTIMAL נתוני תנועה מקיפים ואיכותיים. ההגדרה הזו יוצרת את זמן האחזור הגבוה ביותר, והיא שוות ערך להגדרה departure_time ב-Directions API וב-Distance Matrix API.
ההעדפה הזו שווה למצב שבו נעשה שימוש בכתובת maps.google.com ובאפליקציית מפות Google לנייד.

השוואה בין חישובי מסלולים

בטבלה הבאה מוצגות אפשרויות הניתוב בהשוואה בין Routes API,‏ Directions API ו-Distance Matrix API.

אפשרות תנועה Routes API ‫Directions API
‫Distance Matrix API		 זמן אחזור
אין דיווחי תנועה בזמן אמת TRAFFIC_UNAWARE נכס אחד (departure_time) לא הוגדר החביון הכי נמוך מבין שלושת המצבים.
מצב התנועה בזמן אמת TRAFFIC_AWARE אין דוח מקביל

מצב חדש שנוסף על ידי Routes API. הוא מספק זמן אחזור קצת יותר גדול מ-TRAFFIC_UNAWARE, עם עלות קטנה באיכות ה-ETA.

זמן האחזור שלו נמוך בהרבה מזה של TRAFFIC_AWARE_OPTIMAL.
נתוני תנועה מקיפים בזמן אמת באיכות גבוהה TRAFFIC_AWARE_OPTIMAL departure_time קבוצת נכסים

מקביל למצב שבו נעשה שימוש ב-maps.google.com ובאפליקציית מפות Google לנייד.

ב-Compute Route Matrix, מספר הרכיבים בבקשה (מספר נקודות המוצא × מספר היעדים) לא יכול להיות יותר מ-100.

ההבדלים העיקריים

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

התקשרות לשירות אחד במקום לשני

Routes API מפעילים רק שירות אחד ב-API Console כדי שהאפליקציה תוכל להשתמש ב-Compute Routes וב-Compute Route Matrix.
מידע נוסף זמין במאמר בנושא הגדרה ב-Google API Console.
‫Directions API
‫Distance Matrix API 		מפעילים שני שירותים: Directions API ו-Distance Matrix API כשירותים נפרדים בקונסולה לממשקי API.

נעשה שימוש ב-HTTPS POST בקשות

Routes API מעבירים פרמטרים בגוף הבקשה או בכותרות כחלק מבקשת HTTP POST.
דוגמאות אפשר לראות במאמרים הבאים:
– חישוב מסלול
– חישוב מטריצת מסלולים
‫Directions API
‫Distance Matrix API 		מעבירים פרמטרים של כתובת URL באמצעות בקשת HTTP GET.

הבדלים בתשובות עם הזמן המשוער להגעה

ה-API לניווט מחזיר את זמן ההגעה המשוער (ETA) ומשתמש במאפיין התגובה duration באופן שונה מהשירותים של Directions API ו-Distance Matrix API, כפי שמוצג בטבלה שלמטה.

סוג זמן ההגעה המשוער Routes API ‫Directions API
‫Distance Matrix API
זמן הגעה משוער שלא תלוי במצב התנועה, ולא תלוי בזמן.

הגדרה באמצעות TRAFFIC_UNAWARE.

  • הזמן המשוער להגעה (ETA) כלול במאפיין התגובה duration.
  • מאפייני התגובה duration ו-staticDuration מכילים את אותו ערך.

מקביל למצב שבו הערך departure_time לא מוגדר בבקשה.

  • הזמן המשוער להגעה (ETA) כלול במאפיין התגובה duration.
  • מאפיין התגובה duration_in_traffic לא מוחזר.
זמן הגעה משוער שמתחשב במצב התנועה בזמן אמת.

ההגדרה מתבצעת באמצעות TRAFFIC_AWARE או TRAFFIC_AWARE_OPTIMAL.

  • הזמן המשוער להגעה (ETA) שמתחשב בתנועה בזמן אמת מופיע במאפיין התגובה duration.
  • מאפיין התגובה staticDuration מכיל את משך הנסיעה במסלול בלי להתחשב במצב התנועה.
  • המאפיין duration_in_traffic לא מוחזר יותר.

ההגדרה מתבצעת באמצעות departure_time בבקשה.

  • הזמן המשוער להגעה (ETA) שמתחשב בתנועה בזמן אמת מופיע במאפיין התגובה duration_in_traffic.

נקודות ציון של קו מרובה נקודות

אתם כבר לא צריכים להמיר את קואורדינטות קו הרוחב וקו האורך לנקודות ציון של קו פוליגוני באמצעות השירות הזה, שתומך בגוף של בקשת POST ולכן כבר לא מושפע ממגבלות על מחרוזת כתובת ה-URL. חלק מהמשתמשים ב-Distance Matrix API פתרו את הבעיה של מגבלות הבקשות על ידי המרה של נקודות קווי אורך ורוחב לנקודות ציון של קו פוליגון.

כתובות מעוצבות (המרת קואורדינטות לכתובות)

ה-Routes API לא מספק כתובות בפורמט בתגובה. כדי לקבל כתובות מעוצבות, צריך להשתמש ב-Geocoding API, שנועד לתרחיש השימוש הזה ומספק תוצאות באיכות גבוהה יותר.

אמצעי תחבורה זמינים

כמו במקרה של Directions API, ‏ Routes API משתמש ב-DRIVE כמצב ברירת המחדל כשבקשת מסלול לא מציינת אמצעי תחבורה. עם זאת, כשמציינים בבקשה מצב נסיעה למסלול, Routes API לא מחזיר מערך של מצבי נסיעה זמינים כאפשרויות חלופיות לבקשה. אם תרחיש השימוש שלכם מסתמך על התכונה הזו,אתם יכולים לדווח על בעיה ולתאר איך אתם משתמשים בתכונה, כדי שנוכל לבדוק את הנושא.

‫XML כפורמט תגובה

‫Routes API לא מספק XML כפורמט תגובה. יש באינטרנט מספר ממירים מ-JSON ל-XML שמתאימים למטרה הזו.