API למסלולים לכלי רכב

ה-API של Routes for Automotive מספק מאפיינים מיוחדים לשותפים מתחום כלי הרכב שמפתחים תכונות לניווט במכונית. היא מרחיבה את ה-API הסטנדרטי של Routes עם מאפיינים שמותאמים לתעשיית הרכב.

מה כלול ב-Routes API for Automotive?

בנוסף למסמכי התיעוד של Routes API הסטנדרטי, ה-Routes API for Automotive כולל את הפרטים הבאים:

אישור הבקשות

כדי לאשר את הבקשות ל-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):

תכונות ניסיוניות

התכונות הבאות הן ניסיוניות, והן זמינות רק ללקוחות נבחרים:

מאפייני בסיס שנחשפים דרך Routes API

  • אסימון המסלול נלקח כקלט אופציונלי. למידע נוסף, ניתן לעיין בקטע routeToken בRoute.

מידע שיכול להיות זמין לאורך הקו

  • עיכובי עומסי תנועה נמדדים בדקות של עומס תנועה. ראו IncidentType.
  • אירועים מסוג 'טיפוסים בני מנייה (enum)' ללא פרטים של אירועי טקסט. ראו IncidentInfo.

ראו PolylineDetails.

תכונות אחרות

  • גובה לאורך המסלול. ראו AltitudeInfo.
  • קטגוריות מהירות חזויות לאורך המסלול (8 קטגוריות, כל קטגוריה ברוחב 10-20 קמ"ש). ראו PredictedSpeedInfo.

שינויי מסלול

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

  • אין להשתמש במודעות ביניים (avoidVignettes[]). התכונה נתמכת בשש מדינות: אוסטריה, שווייץ, הונגריה, סלובניה, סלובקיה וצ'כיה.
  • אישור לכבישים עם תפוסה גבוהה (hovPreference). האפשרות נתמכת בארה"ב ובקנדה.
  • ללא מנהרות (avoidTunnels).
  • נתיבים ספציפיים לנגררים (totalAxleCount, totalHeightMm, totalLengthMm, totalWidthMm, totalWeightKg).