ה-Routes API מספק ביצועים משופרים לחישוב מסלולים, מרחק וזמן הגעה, ולכן כדאי יותר להחליף אפליקציות שמשתמשות כרגע ב-Directions API וב-Remote Matrix API. רוב הפונקציונליות של Routes API תואמת לאחור גם ל-Directions API וגם ל-Remote Matrix API.
תוכלו להיעזר במדריך הזה כדי להבין את ההבדלים העיקריים ב-Routes API לעומת המוצרים שהוא מחליף, וגם איך לטפל בשינויים הנדרשים. בסקירה הכללית של המוצרים תוכלו לקרוא פרטים נוספים על תכונות אחרות של Routes API.
שיפורים עיקריים
פירטנו כאן כמה מהשיפורים הצפויים בזמן השימוש ב-Routes API באפליקציות שלכם.
הגדלה של מספר הבקשות
| Routes API |
|
| מרחק API מטריקס |
|
תגובות מהירות יותר לבקשות
התכונה 'מטריצת מסלול המחשוב' מציעה את השיפורים הבאים בזמן האחזור:
- קבלת רכיבי סטרימינג של התגובה לפני החישוב של המטריצה כולה.
- אפשר להשתמש באנונימיזציה של שדות כדי להתאים אישית את פרטי התשובות כדי לבקש רק את הנתונים שנחוצים לכם. השיטה הזו גם עוזרת להקטין את העלויות.
- חישובי מסלולים משופרים לתנועה, שמאפשרים למצוא את ההבדלים בין איכות הנתונים לבין זמן התגובה.
שיפורים במסלול
תכונת מסלול המחשוב מציעה את השיפורים הבאים בתכנון מסלול:
- מידע על כבישי אגרה, בנוסף למרחק ולזמן ההגעה המשוער.
- מסלולים לרכב דו-גלגלי.
- עליכם לוודא שציוני הדרך שלכם עומדים בתחנות הביניים כדי לשמור על הבטיחות.
- שיפור הדיוק של זמן ההגעה המשוער על ידי הגדרת כיוון הנסיעה וצד הדרך עבור ציוני דרך.
מבקשים רק את הנתונים שנחוצים לכם
עכשיו תוכלו לציין אילו שדות להחזיר, וכך לקצר את זמן העיבוד ואת החיובים על החיוב.
| Routes API | הבקשות שלך חייבות להשתמש באנונימיזציה של שדות כדי לציין אילו שדות
רוצים להחזיר בתגובה. אנונימיזציה של שדות מבטיחה שלא תבקשו
נתונים מיותרים, וכך תימנעו מזמן עיבוד ומחיובים
מיותרים.
מידע נוסף זמין במאמר בחירת שדות להחזרה. |
| Directions API מרחק API מטריקס |
מחזירה רשימת ברירת מחדל של שדות, גם אם האפליקציה לא זקוקה להם בקפדנות. התוצאה עשויה להיות זמן עיבוד מיותר וחיובים מיותרים. |
חישובי מסלול משופרים לתנועה
ב-Routes API יש תמיכה בשלוש העדפות ניתוב שבהן תוכלו להשתמש כדי לאזן בין זמן האחזור של התגובה לבין איכות הנתונים כשמבקשים מידע על תעבורת הנתונים.
מידע נוסף זמין במאמר הגדרת איכות לעומת זמן אחזור.
TRAFFIC_UNAWARE (ברירת המחדל) |
המערכת מחשבת את המסלול באמצעות נתוני תנועה שאינם תלויים בזמן הממוצע, ולא בנתוני תנועה בזמן אמת. התוצאה היא זמן אחזור קצר יותר לתגובה. ההגדרה הזו מקבילה למצב שבו לא נעשה שימוש בתעבורת נתונים ב-Directions API וב-Question Matrix API. |
TRAFFIC_AWARE (חדש) |
איכות תנועה בזמן אמת עם אופטימיזציה לביצועים מאפשרת זמן אחזור קצר יותר. בניגוד ל-TRAFFIC_AWARE_OPTIMAL, ההגדרה הזו
מחילה אופטימיזציות כדי לצמצם באופן משמעותי את זמן האחזור.
הגדרה זו חדשה גם ב-Routes API, ללא מקבילה ב-Directions API או ב-מרחק Matrix API.
|
TRAFFIC_AWARE_OPTIMAL |
נתוני תנועה מקיפים ואיכותיים. ההגדרה הזו
יוצרת את זמן האחזור הגבוה ביותר והיא זהה להגדרה departure_time
ב-Directions API וב-מרחק Matrix API. העדפה זו מקבילה למצב שבו משתמשת maps.google.com ואפליקציית מפות Google לנייד. |
השוואה בין חישובי מסלולים
בטבלה הבאה מוצגת השוואה בין אפשרויות הניתוב של השירותים Routes API לבין השירותים Directions API ו-מרחק Matrix API.
| אפשרות תנועה | Routes API | Directions API מרחק API מטריקס |
זמן אחזור |
|---|---|---|---|
| אין תנועה בזמן אמת | TRAFFIC_UNAWARE |
נכס אחד (departure_time) לא הוגדר |
זמן האחזור המהיר ביותר מבין שלושת המצבים. |
| הוחלו תנאי תנועה בזמן אמת | TRAFFIC_AWARE |
אין דוח מקביל | מצב חדש נוסף על ידי Routes API. זהו זמן אחזור קצת יותר ארוך בהשוואה ל- זמן האחזור שלה נמוך בהרבה מאשר ב- |
| הוחלו נתונים מקיפים על תנועת הגולשים בזמן אמת באיכות גבוהה | TRAFFIC_AWARE_OPTIMAL |
קבוצת נכסים אחת (departure_time) |
זהה למצב שבו נעשה שימוש ב-maps.google.com ובאפליקציה לנייד של מפות Google. עבור מטריצת המסלול של Compute, מספר הרכיבים בבקשה (מספר המקורות כפול מספר היעדים) לא יכול להיות גדול מ-100. |
הבדלים עיקריים
בקטע הזה מתוארים ההבדלים העיקריים בין Routes API לבין השירותים שהוא מחליף, ודרכים שבהן תוכלו לטפל בהבדלים האלה במהלך ההעברה מהשירותים האלה באפליקציות הקיימות שלכם.
התקשרות לשירות אחד במקום לשני שירותים
| Routes API | צריך להפעיל רק שירות אחד ב-API Console לאפליקציה שלך
לצורך שימוש ב-Compute Routes וב-Compute Route Matrix.
למידע נוסף, ראו הגדרה ב-Google API Console. |
| Directions API מרחק API מטריקס |
מפעילים שני שירותים: Directions API ו-מרחק Matrix API כשירותים נפרדים במסוף API. |
נעשה שימוש ב-HTTPS POST בקשות
| Routes API | העברת פרמטרים בגוף הבקשה או
בכותרות כחלק מבקשת HTTP POST. לדוגמה: - Compute a route - Compute a route matrix (חישוב מטריצת מסלולים) |
| Directions API מרחק API מטריקס |
העברה של פרמטרים של כתובת אתר באמצעות בקשת HTTP GET. |
הבדלים בתגובות בזמן ההגעה המשוער
ה-Routes API מחזיר זמן הגעה משוער ומשתמש במאפיין התגובה duration, באופן שונה משירותי ה-API של Directions API ו-מרחק Matrix API, כפי שמתואר בטבלה הבאה.
| סוג זמן ההגעה המשוער | Routes API | Directions API מרחק API מטריקס |
|---|---|---|
| זמן הגעה משוער לא מודע לתנועה ובלתי תלוי בזמן. | הגדרה באמצעות
|
תואם לערך
|
| זמן הגעה משוער שמתחשב בתנועה בזמן אמת. | הגדרה באמצעות
|
מוגדר באמצעות
|
ציוני דרך בקו מרובה
בשירות הזה כבר אין צורך להמיר את הקואורדינטות של קווי האורך והרוחב לנקודות דרך קוויות דו-כיווניות, שתומך בגוף של בקשת POST, ולכן הוא לא מושפע יותר מהמגבלות של מחרוזות כתובות URL. חלק מהמשתמשים של Remote Matrix API טיפלו בבעיה של מגבלות הבקשות על ידי המרת נקודות של קווי אורך ורוחב לנקודות דרך פוליגונים.
כתובות מעוצבות (גיאוגרפי הפוך)
ה-Routes API לא סיפק כתובות בפורמט הנכון בתשובה. כדי לקבל כתובות בפורמט המתאים, כדאי להשתמש ב-Geocoding API שמיועד לתרחיש לדוגמה הזה ומספק תוצאות באיכות גבוהה יותר.
אמצעי הגעה זמינים
כמו ב-Directions API, ב-Routes API נעשה שימוש ב-Drive בתור מצב ברירת המחדל במקרים שבהם בבקשה למסלול לא מצוין מצב הנסיעה. עם זאת, כשבבקשה מצוין מצב נסיעה של מסלול, ה-Routes API לא מחזיר מערך של מצבי נסיעה זמינים כאפשרויות חלופיות לבקשה. אם התרחיש לדוגמה שלכם מסתמך על התכונה הזו,דווחו על בעיה שמתארת את אופן השימוש שלכם בה, כדי שנוכל להמשיך לטפל בבעיה.
XML כפורמט תשובה
ה-Routes API לא מספק XML כפורמט תגובה. תוכלו למצוא באינטרנט מספר ממירים של JSON ל-XML שיתאימו למטרות שלכם.