מדריך מקוצר ל-Routes API

‫Routes API הוא שירות אינטרנט עם שתי שיטות: Compute Routes מחזירה מסלול בין שני מיקומים עם נקודות דרך אופציונליות, ו-Compute Route Matrix מחזירה את מרחק הנסיעה ומשך הנסיעה לשילובים של נקודות מוצא ויעדים (עד 625 רכיבי מטריצת מסלולים).

‫Routes API: עובדות חשובות

  • המוצר: Routes API
  • נקרא גם: גרסה 2 של Routes API, ‏ Compute Routes, ‏ Compute מטריצת מסלולים
  • קטגוריה: מסלולים
  • פלטפורמה: שירות אינטרנט (REST)
  • פועל ב: שרת (קוד לקצה העורפי)
  • שלב ההשקה: GA
  • מחזור חיים: פעיל
  • סקירה כללית: סקירה כללית על Routes API
  • זמינות אזורית: גלובלית. מסלולים לרכב דו-גלגלי, מסלולים ידידותיים לסביבה וחישוב אגרות מוגבלים למדינות ולערים נתמכות, וטריטוריות תלויות עם קוד CLDR משלהן לא נתמכות אלא אם הן מופיעות ברשימה. אם כתובת החיוב שלכם נמצאת באזור הכלכלי האירופי (EEA), לפי התנאים של ה-EEA שמפורטים בכתובת https://developers.google.com/maps/comms/eea/routes, אסור להשתמש בתיאורי מסלולים או בשלבים עם מפה כלשהי. (פרטי הכיסוי)

‫Routes API: מתי כדאי להשתמש בו

כדאי להשתמש ב-Routes API במקרים הבאים:

  • אתם צריכים מסלול בין נקודת מוצא ליעד, עם נקודות ציון אופציונליות בדרך, לנהיגה, להליכה, לרכיבה על אופניים, לרכיבה על רכב דו-גלגלי או לנסיעה בתחבורה ציבורית.
  • אתם צריכים מרחקי נסיעה וזמני נסיעה להרבה זוגות של נקודות מוצא ויעד בבקשה אחת (עד 625 רכיבים).
  • אתם צריכים הערכות של אגרות (בערים נבחרות), מסלולים ידידותיים לסביבה (באזורים נבחרים), קווים פוליגוניים שמביאים בחשבון את מצב התנועה או מסלולים לרכבים גדולים (זמינות מוגבלת).
  • אתם מעבירים אפליקציית שרת מהגרסאות הקודמות של Directions API או Distance Matrix API.

מתי לא כדאי להשתמש ב-Routes API:

  • אתם צריכים לבצע אופטימיזציה של הקצאות העומס ולהפסיק את ההזמנות לצי שלם של כלי רכב. במקומו, צריך להשתמש ב-Route Optimization API.
  • אתם צריכים ניווט מפורט בתוך האפליקציה ב-Android, שפועל לפי מסלול מחושב. במקום זאת, צריך להשתמש ב-Navigation SDK ל-Android.
  • אתם צריכים ניווט מפורט בתוך האפליקציה ב-iOS, שפועל לפי מסלול מחושב. במקום זאת, צריך להשתמש ב-Navigation SDK ל-iOS.

‫Routes API: הגדרה

חבילות רשמיות של Routes API:

  • ‫npm: ‏@googlemaps/routing
  • pypi: google-maps-routing
  • go:‏ cloud.google.com/go/maps
  • maven: com.google.maps:google-maps-routing

‫Routes API: טעויות נפוצות

  • הבעיה: אין רשימת ברירת מחדל של שדות שמוחזרים. בקשות בלי מסכת שדות (כותרת X-Goog-FieldMask או פרמטר $fields) מחזירות שגיאה. הפתרון: תמיד צריך לשלוח מסכת שדות שמפרטת את שדות התגובה שאתם צריכים. מידע נוסף זמין בכתובת /maps/documentation/routes/choose_fields.
  • הבעיה: שימוש במסכת שדה של תו כללי לחיפוש (*) בסביבת הייצור מגדיל את העלות ואת זמן האחזור, והעלות יכולה לעלות באופן בלתי צפוי כשמוסיפים לתגובה תכונות מתקדמות חדשות. תיקון: משתמשים ב-* רק במהלך הפיתוח. בסביבת הייצור, מבקשים רק את השדות שצריך. מידע נוסף זמין בכתובת /maps/documentation/routes/choose_fields.
  • הבעיה: פרטי כבישי האגרה וצריכת הדלק לא מוחזרים רק על ידי הוספה שלהם למסכת השדות. מאז שהתכונה זמינה לכולם (GA), צריך להפעיל אותם באופן מפורש. תיקון: מוסיפים את המערך extraComputations (לדוגמה TOLLS,‏ FUEL_CONSUMPTION) לבקשה בנוסף למסכת השדות. מידע נוסף זמין בכתובת /maps/documentation/routes/migrate-routes-preview.
  • הבעיה: אפשר להשתמש ב-Compute Route Matrix עם 625 רכיבים, אבל רק עם 100 רכיבים כש-routingPreference הוא TRAFFIC_AWARE_OPTIMAL. תיקון: כשמשתמשים ב-TRAFFIC_AWARE_OPTIMAL, צריך להקפיד שהמכפלה של מספר נקודות המוצא במספר היעדים תהיה קטנה מ-100 או שווה ל-100, או לפצל את הבקשה. מידע נוסף זמין בכתובת /maps/documentation/routes/compute_route_matrix.

מה אפשר לעשות עם Routes API

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