ה-API של המסלול לכלי רכב מספק מאפיינים מיוחדים לשותפי רכב שמפתחים תכונות לניווט ברכב. הוא מרחיב את ממשקי ה-API הרגילים למסלולים עם מאפיינים שמותאמים לתעשיית הרכב.
מה כלול בתיעוד של Routes API for Automotive
בנוסף למסמכי התיעוד של Routes API הרגיל, ה-Routes API for Automotive כולל את הפרטים הבאים:
- נתוני גרסה (כלי רכב)
- שימוש ב-OAuth (כלי רכב)
- ספריות לקוח (כלי רכב)
- הפניית REST (כלי רכב)
- חומר עזר ל-RPC (כלי רכב)
אישור הבקשות שלך
כדי לאשר את הבקשות ל-annotatePaths, צריך להשתמש בשיטת OAuth שמתוארת כאן: שימוש ב-OAuth (Automotive). הבקשות מחייבות שימוש בהתחזות באמצעות OAuth, בדומה לאופן שבו קוראים ל-Automotive Maps API (אבל בהיקף שונה).
עם זאת, כשקוראים ל-methods computeRoutes או computeRoutesMatrix, אפשר להשתמש בכל אחד מסוגי ההרשאות שמתוארים במסמכי התיעוד הרגילים של Routes API: מפתחות API או OAuth.
תיעוד משותף עם Standard Routes API
מסמכי התיעוד של Routes API לכלי רכב משותפים עם ה-Routes API הסטנדרטי, כמו מדריכים בכרטיסייה 'מדריכים'.
שימו לב שכאשר משתמשים במדריכים הרגילים של Routes API, הקישורים מצביעים על קובץ העזר הרגיל. עליכם לעבור לקישור המקביל ב-Routes API for Automotive. תוכלו לעשות זאת על ידי הוספת automotive/ אחרי routes/ בכתובת ה-URL של הדפדפן, כמו routes/automotive/.
קבלת עזרה
מכיוון שה-Routes API לכלי רכב לא זמין באופן ציבורי, אנחנו מבקשים להימנע משליחת באגים נגדו לשירות הציבורי שלנו למעקב אחר בעיות. סיפקנו לצוות שלכם רכיב ספציפי לחברה למעקב אחר בעיות, שבו אפשר לדווח על באגים. אם יש לך שאלות נוספות, עליך לפנות לאיש הקשר שלך ב-Google.
מוסכמות ומינוחים של מקרה גמל
במסמכי התיעוד נעשה שימוש בעיקר במוסכמות לגבי שימוש בקאמל בארכיטקטורת REST (כמו annotatePaths) במקום במוסכמות אותיות רישיות של RPC (AnnotatePaths).
עם זאת, שני סוגי האותיות תקפים באופן שווה.
בנוסף, למרות שמקובל להתייחס ל-annotatePaths, ל-computeRoutes או ל-computeRoutesMatrix כ-'APIs', מדובר בפועל ב-methods בהתאמה אישית. עם זאת, יכול להיות שהם ייקראו methods או ממשקי API.
Google Analytics (זמינות לכלל המשתמשים) ותכונות ניסיוניות
בקטע הזה מתוארים המאפיינים הייחודיים ב-Routes API for Automotive. התכונות הבאות זמינות לכלל המשתמשים.
מאפייני בסיס שנחשפים דרך Routes API
קו פוליגוני E7 (הקו הפוליגוני המקודד הסטנדרטי שמתואר עם קואורדינטות E7 במקום E5):
- להימנע ממעבורות. ראו
FerryInfo - הימנעות מכבישי אגרה. ראו
TollInfo - [תצוגה מקדימה] בחירת מסלול חסכוני בהתאם לסוג המנוע. פרטים נוספים זמינים במאמר קבלת מסלול ידידותי לסביבה.
תכונות ניסיוניות
התכונות הבאות הן ניסיוניות וזמינות רק ללקוחות נבחרים:
מאפייני בסיס שנחשפים דרך Routes API
- אסימון הנתיב נלקח כקלט אופציונלי. אפשר לעיין ב
routeTokenבRoute.
מידע שיכול להיות זמין לאורך הקו הפוליגוני
- עיכובים בגלל עומסי תנועה שנמדדים בדקות. פרטים נוספים זמינים בכתובת
IncidentType. - אירועים מסוג 'טיפוסים בני מנייה (enum)' ללא פרטים של אירועי טקסט. פרטים נוספים זמינים בכתובת
IncidentInfo.
פרטים נוספים זמינים בכתובת PolylineDetails.
תכונות אחרות
- גובה לאורך המסלול. פרטים נוספים זמינים בכתובת
AltitudeInfo. - קטגוריות המהירות הצפויות לאורך המסלול (8 קטגוריות, כל קטגוריה ברוחב 10 עד 20 קמ"ש). פרטים נוספים זמינים בכתובת
PredictedSpeedInfo.
שינויי מסלול
אפשר להפעיל את RouteModifiers הבא מה-API. עם זאת, יכול להיות שהנתיבים לא יתאימו ליעד השינוי כי הם עדיין נמצאים בפיתוח ובבדיקה. אם יש לכם שאלות, אתם יכולים לפנות לנציג Google.
- להימנע ממודעות ביניים (
avoidVignettes[]). האפשרות הזו נתמכת ב-6 מדינות: אוסטריה, שווייץ, הונגריה, סלובניה, סלובקיה וצ'כיה. - אישור לשימוש בכבישים רבי תפוסה (
hovPreference). האפשרות הזו נתמכת בארה"ב ובקנדה. - בלי מנהרות (
avoidTunnels). - מסלולים ספציפיים לנגררים (
totalAxleCount,totalHeightMm,totalLengthMm,totalWidthMm,totalWeightKg).