ב-Routes API יש ביצועים משופרים לחישוב מסלולים, מרחקים וזמן נסיעה, ולכן כדאי להחליף אפליקציות שמשתמשות כרגע ב-Directions API וב-Distance Matrix API. רוב הפונקציונליות של Routes API תואמת לאחור גם ל-Directions API וגם ל-Distance Matrix API.
המדריך הזה יעזור לכם להבין את ההבדלים העיקריים בין Routes API לבין המוצרים שהוא מחליף, וגם איך לבצע את השינויים הנדרשים. פרטים נוספים על תכונות אחרות של Routes API מופיעים בסקירה הכללית על המוצר.
שיפורים מרכזיים
בקטע הזה מפורטים חלק מהשיפורים שצפויים כשמשתמשים ב-Routes API באפליקציות.
הגדלת מגבלות הבקשות
| Routes API |
|
| Distance Matrix API |
|
תגובות מהירות יותר לבקשות
התכונה 'מטריצה של מסלולי מחשוב' מציעה את השיפורים הבאים בזמן האחזור:
- לקבל רכיבים של התגובה בסטרימינג לפני שכל המטריצה מחושבת.
- שימוש במסכות שדות כדי להתאים אישית את פרטי התשובה, כך שתבקש רק את הנתונים שדרושים לך. זוהי שיטה מומלצת שגם עוזרת להפחית את העלות.
- חישובי מסלולים משופרים לתנועה, כדי שתוכלו לשקול את הפשרה בין איכות הנתונים לבין זמן התגובה.
שיפורים בניתוב
התכונה compute route כוללת את שיפורי הניתוב הבאים:
- פרטי כבישי אגרה בנוסף למרחק ולזמן ההגעה המשוער.
- מסלולים לכלי רכב דו-גלגליים.
- כדאי לבדוק את נקודות העצירה מטעמי בטיחות.
- שיפור הדיוק של זמן ההגעה המשוער על ידי הגדרת כיוון הנסיעה וצד הכביש לנקודות ציון.
מבקשים רק את הנתונים הנחוצים
עכשיו אפשר לציין אילו שדות להחזיר, וכך לקצר את זמן העיבוד ואת החיובים.
| Routes API | בבקשות צריך להשתמש במסכת שדות כדי לציין את השדות שרוצים להחזיר בתגובה. אנו ממליצים להשתמש בהסתרת שדות כדי שלא תבקשו נתונים מיותרים, וכך לחסוך בזמן העיבוד ובחיובים.
מידע נוסף זמין במאמר בחירת שדות להחזרה. |
| 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_AWARE_OPTIMAL |
קבוצת נכסים departure_time |
זהו המצב שבו נעשה שימוש ב-maps.google.com ובאפליקציה לנייד של מפות Google. ב-Compute Route Matrix, מספר הרכיבים בבקשה (מספר המקוריים x מספר היעדים) לא יכול לחרוג מ-100. |
ההבדלים העיקריים
בקטע הזה נסביר על ההבדלים העיקריים בין Routes API לבין השירותים שהוא מחליף, ונספק דרכים להתמודדות עם ההבדלים האלה במהלך המעבר מהשירותים האלה באפליקציות הקיימות.
קריאה לשירות אחד במקום לשני
| Routes API | כדי שהאפליקציה שלכם תוכל להשתמש ב-Compute Routes וב-Compute Route Matrix, צריך להפעיל רק שירות אחד במסוף ה-API.
מידע נוסף זמין במאמר הגדרה במסוף Google API. |
| 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 מחזיר זמן הגעה משוער ומשתמש במאפיין התגובה duration באופן שונה מאשר בשירותי ה-Directions API ו-Distance Matrix API, כפי שמתואר בטבלה שבהמשך.
| סוג זמן ההגעה המשוער | Routes API | Directions API Distance Matrix API |
|---|---|---|
| זמן הגעה משוער ללא מידע על תנועה, ללא תלות בזמן. | מגדירים באמצעות
|
התוצאה תואמת למצב שבו השדה
|
| זמן הגעה משוער שמביא בחשבון את מצב התנועה בזמן אמת. | מגדירים באמצעות
|
מגדירים באמצעות
|
נקודות דרך בקו פוליגוני
בעזרת השירות הזה, כבר לא צריך להמיר את קואורדינטות הרוחב/האורך לנקודות ציון של קווים פוליגונליים. השירות תומך בגוף של בקשת POST, ולכן הוא לא מושפע יותר ממגבלות על מחרוזות של כתובות URL. משתמשים מסוימים ב-Distance Matrix API פתרו את הבעיה של מגבלות הבקשות על ידי המרת נקודות קו הרוחב/האורך לנקודות ציון של קווים פוליגונליים.
כתובות בפורמט (המרת קואורדינטות לכתובות)
Routes API לא מספק כתובות בפורמט בתגובה. כדי לקבל כתובות בפורמט, צריך להשתמש ב-Geocoding API, שנועד למקרה לדוגמה הזה ומספק תוצאות באיכות גבוהה יותר.
אמצעי ההגעה הזמינים
בדומה ל-Directions API, ב-Routes API המצב שמוגדר כברירת מחדל הוא 'נסיעה' כשלא צוין אמצעי תחבורה בבקשה למסלול. עם זאת, אם בבקשה מצוין סוג תחבורה למסלול, ה-Routes API לא מחזיר מערך של סוגי תחבורה זמינים כאפשרויות חלופיות לבקשה. אם התרחיש לדוגמה שלכם מסתמך על התכונה הזו,פנו אלינו כדי לדווח על הבעיה ולתאר את אופן השימוש שלכם בתכונה, כדי שנוכל להמשיך לטפל בבעיה.
XML כפורמט תגובה
ה-API של Routes לא מספק XML כפורמט תגובה. באינטרנט יש כמה ממירים של JSON ל-XML שיכולים להתאים למטרות שלכם.