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

ב-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 רכיבים (מספר המקוריים x מספר היעדים) לכל בקשה בצד השרת.

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

התכונה Compute Route Matrix מציעה את השיפורים הבאים בזמן האחזור:

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

שיפורים בניתוב

התכונה compute route כוללת את שיפורי הניתוב הבאים:

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

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

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

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, מספר הרכיבים בבקשה (מספר מקורות 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
זמן הגעה משוער ללא מידע על תנועה, ללא תלות בזמן.	מגדירים באמצעות TRAFFIC_UNAWARE. זמן הצגת המודעה המשוער שמופיע במאפיין התגובה duration. מאפייני התגובה duration ו-staticDuration מכילים את אותו ערך.	התוצאה תואמת למצב שבו השדה departure_time לא מוגדר בבקשה. זמן האספקה המשוער שמופיע במאפיין התגובה 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 המצב שמוגדר כברירת מחדל הוא 'נסיעה' כשלא צוין אמצעי תחבורה בבקשה למסלול. עם זאת, אם בבקשה מצוין סוג תחבורה למסלול, ה-Routes API לא מחזיר מערך של סוגי תחבורה זמינים כאפשרויות חלופיות לבקשה. אם התרחיש לדוגמה שלכם מסתמך על התכונה הזו,פנו אלינו כדי לדווח על הבעיה ולתאר את אופן השימוש שלכם בתכונה, כדי שנוכל להמשיך לטפל בבעיה.

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

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