ה-API של Routes for Automotive מספק מאפיינים מיוחדים לשותפים מתחום כלי הרכב שמפתחים תכונות לניווט במכונית. היא מרחיבה את ה-API הסטנדרטי של Routes עם מאפיינים שמותאמים לתעשיית הרכב.
מה כלול ב-Routes API for Automotive?
בנוסף למסמכי התיעוד של Routes API הסטנדרטי, ה-Routes API for Automotive כולל את הפרטים הבאים:
- נתוני גרסה (כלי רכב)
- שימוש ב-OAuth (כלי רכב)
- ספריות לקוח (Automotive)
- חומר עזר בנושא REST (Automotive)
- חומר עזר בנושא RPC (כלי רכב)
אישור הבקשות
כדי לאשר את הבקשות ל-annotatePaths
, צריך להשתמש בשיטת OAuth שמתוארת כאן: שימוש ב-OAuth (Automotive). הבקשות מחייבות שימוש בהתחזות באמצעות OAuth, בדומה לאופן שבו קוראים ל-Auto Maps API (אבל עם היקף שונה).
עם זאת, אם קוראים לשיטות computeRoutes
או computeRoutesMatrix
, אפשר להשתמש בכל אחד מסוגי ההרשאות שמתוארים במסמכי Routes API הרגילים: מפתחות API או OAuth.
תיעוד משותף עם Standard Routes API
המסמכים מ-Routes API for Automotive משתפים את המסמכים עם ה-Routes API הרגיל, כמו מדריכים בכרטיסייה Guides.
שימו לב שכאשר משתמשים במדריכים הרגילים של Routes API, הקישורים מפנים אל ההפניה הרגילה. עליכם לעבור לקישור המקביל ב-Routs API לצורך עיון ב-Automotive. תוכלו לעשות זאת על ידי הוספת automotive/
אחרי routes/
לכתובת ה-URL של הדפדפן, באופן הבא: routes/automotive/
.
קבלת עזרה
מכיוון שה-API של Routes for Automotive לא זמין לציבור, אנחנו מבקשים להימנע משליחת באגים לגביו ל'מעקב אחר בעיות' הציבורי שלנו. סיפקנו לצוות שלך רכיב ספציפי לחברה למעקב אחר בעיות, שבאמצעותו ניתן לדווח על באגים. אם יש לך שאלות נוספות, אפשר לפנות לאיש הקשר שלך ב-Google.
מוסכמות וטרמינולוגיה של אותיות גמלים
התיעוד משתמש בעיקר במוסכמות של כיסוי גמלים ב-REST (כמו annotatePaths
) במקום במוסכמות של כיסוי גמל RPC (AnnotatePaths
).
עם זאת, שתי המכסות תקפות באותה מידה.
בנוסף, על אף שנהוג להתייחס ל-annotatePaths
, ל-computeRoutes
או ל-computeRoutesMatrix
בתור 'ממשקי API', אלו למעשה שיטות מותאמות אישית. עם זאת, יכול להיות שהן נקראות שיטות או ממשקי 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[]
). התכונה נתמכת בשש מדינות: אוסטריה, שווייץ, הונגריה, סלובניה, סלובקיה וצ'כיה. - אישור לכבישים עם תפוסה גבוהה (
hovPreference
). האפשרות נתמכת בארה"ב ובקנדה. - ללא מנהרות (
avoidTunnels
). - נתיבים ספציפיים לנגררים (
totalAxleCount
,totalHeightMm
,totalLengthMm
,totalWidthMm
,totalWeightKg
).