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

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

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

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

שיפורים מרכזיים

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

מגבלות נרחבות יותר על בקשות

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

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

התכונה "חישוב מטריצת מסלולים" מציעה את השיפורים הבאים בזמן האחזור:

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

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

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

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

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

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

‫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.

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

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

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

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

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

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

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

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

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

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

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