ה-Routes API מספק ביצועים משופרים לחישוב מסלול, המרחק וזמן הנסיעה, ולכן משתלם להחליף אפליקציות שמשתמשות כרגע ב-Directions API וב-Distance Matrix API. רוב הפונקציונליות של Routes API תואמת לאחור גם ל-Directions API וגם ל-Distance Matrix API.
המדריך הזה יעזור לכם להבין את ההבדלים העיקריים ב-Routes API בהשוואה למוצרים שהוא מחליף, וגם איך להתמודד עם השינויים הנדרשים. לפרטים נוספים על תכונות אחרות של Routes API, קראו את הסקירה הכללית על המוצר.
שיפורים מרכזיים
בקטע הזה מתוארים כמה מהשיפורים הצפויים כשמשתמשים ב-Routes API באפליקציות.
הגדלה של מגבלות הבקשות
| Routes API |
|
| מרחק מטריצת ה-API |
|
מענה מהיר יותר לבקשות
התכונה מטריצת נתיבי המחשוב מציעה את השיפורים הבאים בזמן האחזור:
- לקבל רכיבי סטרימינג של התשובה לפני חישוב המטריצה כולה.
- שימוש במסכות של שדות כדי להתאים אישית את פרטי התשובות – שיטה מומלצת שגם עוזרת לכם לצמצם את העלות.
- חישובי מסלולים משופרים לתעבורת הנתונים, כדי לאפשר השוואה בין איכות הנתונים לזמן התגובה.
שיפורי ניתוב
התכונה 'נתיב המחשוב' מציעה את שיפורי הניתוב הבאים:
- מידע על כבישי האגרה, בנוסף למרחק ולזמן ההגעה המשוער.
- מסלולים לכלי רכב דו-גלגליים.
- כדי לשמור על הבטיחות, עליך לעמוד בדרישות של ציוני הדרך שעוברים עצירה.
- שיפור הדיוק של זמן ההגעה המשוער על ידי הגדרה של כיוון הנסיעה וצידו בכביש עבור ציוני דרך.
מבקשים רק את הנתונים הנחוצים
עכשיו תוכלו להגדיר אילו שדות להחזיר, וכך לקצר את זמן העיבוד ואת חיובי החיוב.
| Routes API | הבקשות צריכות להשתמש במסכת שדות כדי לציין אילו שדות רוצים
להחזיר בתשובה. אנונימיזציה של שדות מבטיחה שלא תבקשו
נתונים מיותרים, וכך מונעת זמן עיבוד וחיובים מיותרים.
תוכלו לקרוא מידע נוסף במאמר בחירת שדות להחזרה. |
| Directions API Distance Matrix API |
מחזירה רשימת ברירת מחדל של שדות, גם אם האפליקציה לא צריכה אותם בלבד. התוצאה עלולה להיות זמן עיבוד וחיובים מיותרים. |
חישובי מסלולים משופרים לתנועה
ב-Routes API יש תמיכה בשלוש העדפות ניתוב, שאפשר להשתמש בהן כדי לאזן בין זמן האחזור של התגובה לבין איכות הנתונים כשמבקשים מידע על תעבורת הנתונים.
תוכלו לקרוא מידע נוסף במאמר הגדרת איכות לעומת זמן אחזור.
TRAFFIC_UNAWARE (ברירת מחדל) |
נעשה שימוש בנתוני תנועה שאינם תלויים בזמן הממוצע, ולא בנתוני תנועה בזמן אמת, כדי לחשב את המסלול, וכך זמן האחזור של התגובה הנמוך ביותר. ההגדרה הזו מקבילה למקרים שבהם לא נעשה שימוש בתעבורת הנתונים ב-Directions API וב-Destination Matrix API. |
TRAFFIC_AWARE (חדש) |
איכות תנועה בזמן אמת עם אופטימיזציה לביצועים
לקצר את זמן האחזור. בניגוד ל-TRAFFIC_AWARE_OPTIMAL, ההגדרה הזו
מחילה אופטימיזציה כדי לצמצם משמעותית את זמן האחזור.
ההגדרה הזו חדשה גם ל-Routee 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_AWARE_OPTIMAL |
קבוצת נכסים departure_time |
זהה למצב שבו משתמשת maps.google.com ולאפליקציית מפות Google לנייד. במטריצת המסלול של Compute, מספר הרכיבים בבקשה (מספר המקורות × מספר היעדים) לא יכול לחרוג מ-100. |
הבדלים עיקריים
בקטע הזה מתוארים ההבדלים העיקריים בין Routes API לבין השירותים שהוא מחליף, וגם דרכים לטיפול בהבדלים האלה במעבר מהשירותים האלה באפליקציות הקיימות שלכם.
התקשרות לשירות אחד במקום לשניים
| Routes API | צריך להפעיל רק שירות אחד במסוף ה-API לאפליקציה שלך כדי להשתמש ב-Compute Routes וב-Compute Route Route.
למידע נוסף, ראו הגדרה ב-Google API Console. |
| Directions API Distance Matrix API |
מפעילים שני שירותים: Directions API ו-Distance Matrix API כשירותים נפרדים במסוף ה-API. |
נעשה שימוש בבקשות HTTPS POST
| Routes API | העברה של פרמטרים בגוף הבקשה או בכותרות כחלק מבקשת HTTP POST. דוגמאות: - Compute a path - מטריצת מסלול ב-Compute a |
| Directions API Distance Matrix API |
העברת פרמטרים של כתובות אתרים באמצעות בקשת HTTP GET. |
הבדלים בתגובות לזמן הגעה משוער
ה-Routes API מחזיר זמן הגעה משוער ומשתמש במאפיין התגובה duration באופן שונה משירותי Directions API ו-Distance Matrix API, כפי שמוצג בטבלה שלמטה.
| סוג זמן הגעה משוער | Routes API | Directions API Distance Matrix API |
|---|---|---|
| זמן הגעה משוער לא מודע וללא קשר לזמן. | הגדרה באמצעות
|
תואם לערך של
|
| זמן הגעה משוער שמביא בחשבון את התנועה בזמן אמת. | מגדירים באמצעות
|
מוגדר באמצעות
|
ציוני דרך עם קו פוליגוני
כבר לא צריך להמיר את הקואורדינטות של קווי האורך והרוחב לקווים פוליגוניים באמצעות השירות הזה, שתומך בגוף בקשת POST, ולכן הוא לא מושפע יותר מהמגבלות של מחרוזות כתובות URL. חלק מהמשתמשים ב-Destination Matrix API טיפלו בבעיה במגבלות הבקשות על ידי המרה של נקודות גובה/אורך ונקודות ציון עם קווים פוליגוניים.
כתובות בפורמט שהוגדר (קידוד גיאוגרפי הפוך)
ה-Routes API לא סיפק כתובות בפורמט הנכון בתשובה. כדי לקבל כתובות בפורמט המתאים, צריך להשתמש ב-Geocoding API, שמיועד לתרחיש לדוגמה הזה ומספק תוצאות באיכות גבוהה יותר.
אמצעי ההגעה הזמינים
בדומה ל-Directions API, ה-Routes API משתמש ב-drive כמצב ברירת המחדל כשבקשה למסלול לא מציינת מצב נסיעה. אבל כשבקשה מציינת מצב נסיעה למסלול, ה-Routes API לא מחזיר מערך של מצבי נסיעה זמינים כאפשרויות חלופיות לבקשה. אם התרחיש לדוגמה שלכם מסתמך על התכונה הזו,עליכם לדווח על בעיה שתתאר את אופן השימוש שלכם בתכונה, כדי שנוכל להמשיך לטפל בנושא.
XML כפורמט תגובה
ה-Routes API לא מספק XML כפורמט תגובה. אפשר למצוא באינטרנט כמה ממירים של JSON ל-XML שמתאימים למטרות שלכם.