למה כדאי לעבור ל-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 Console.

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

הגדרה באמצעות 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 פתרו את הבעיה של מגבלות הבקשות על ידי המרת נקודות של קווי רוחב ואורך לנקודות ציון של קו פוליגון.

כתובות בפורמט מסוים (המרת קואורדינטות לכתובות)

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

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

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

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

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