כולל מידע על מסלול שמחושב עבור צמד מקור/יעד ב-v1alpha.computeRouteMatrix API. ניתן לשדר את ה-Proto הזה ללקוח.
ייצוג JSON |
---|
{ "originIndex": integer, "destinationIndex": integer, "status": { object ( |
שדות | |
---|---|
originIndex |
אינדקס מבוסס אפס של מקור הבקשה. |
destinationIndex |
אינדקס מבוסס אפס של היעד בבקשה. |
status |
קוד הסטטוס של שגיאה לאלמנט הזה. |
condition |
מציין אם המסלול נמצא או לא. ללא תלות בסטטוס. |
distanceMeters |
מרחק הנסיעה של המסלול, במטרים. |
duration |
משך הזמן שנדרש כדי לנווט במסלול. אם מגדירים את משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
staticDuration |
משך הנסיעה במסלול בלי להביא בחשבון את מצב התנועה. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
travelAdvisory |
מידע נוסף על המסלול. לדוגמה: מידע על הגבלות ומידע על כבישי אגרה |
fallbackInfo |
במקרים מסוימים שבהם השרת לא יכול לחשב את המסלול עם ההעדפות הנתונים עבור צמד המקור/היעד הספציפי, יכול להיות שהוא יחזור להשתמש במצב חישוב אחר. כשמשתמשים במצב חלופי, השדה הזה מכיל מידע מפורט על התשובה החלופית. אחרת, השדה הזה לא מוגדר. |
סטטוס
הסוג Status
מגדיר מודל שגיאות לוגי שמתאים לסביבות תכנות שונות, כולל ממשקי API ל-REST וממשקי API ל-RPC. הוא נמצא בשימוש של gRPC. כל הודעת Status
מכילה שלושה נתונים: קוד שגיאה, הודעת שגיאה ופרטי שגיאה.
במדריך לעיצוב API אפשר לקרוא מידע נוסף על מודל השגיאות הזה ולהבין איך לעבוד איתו.
ייצוג JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
שדות | |
---|---|
code |
קוד הסטטוס, שצריך להיות ערך enum של |
message |
הודעת שגיאה שמיועדת למפתחים וצריכה להיות באנגלית. כל הודעת שגיאה שמוצגת למשתמשים צריכה להיות מותאמת לשוק המקומי ולשלוח אותה בשדה |
details[] |
רשימה של הודעות שמכילות את פרטי השגיאה. יש כמה סוגים של הודעות שאפשר להשתמש בהם בממשקי API. אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |