Method: annotatePaths (Automotive)

מחזירה את הנתיבים המבוססים על קטעי קלט בחזרה עם הערות עבור מאפיינים דינמיים לאורך הנתיבים.

בקשת HTTP

POST https://routes.googleapis.com/annotations/v2:annotatePaths

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "paths": [
    {
      object (Path)
    }
  ],
  "annotationOptions": {
    object (AnnotationOptions)
  }
}
שדות
paths[]

object (Path)

חובה. הנתיבים המבוקשים למילוי של נתוני מאפיינים דינמיים. כל הנתיבים צריכים לכלול את אותו פלח התחלה, כלומר הקטע שבו הרכב נמצא כרגע. ההנחה היא שהרכב נמצא בתחילת הקטע הראשון. אם הנתיבים לא מתחילים באותו מקטע, תוחזר שגיאה.
annotationOptions

object (AnnotationOptions)

חובה. מאפייני הנתונים הדינמיים המבוקשים שיש להוסיף בנתיבי הקלט. אם הבקשה ריקה, לא יהיו הערות.

גוף התשובה

התגובה AnnotatePathsResponse מכילה את נתיבי הקלט עם נתונים נוספים שנוספו לכל ההערות המבוקשות.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "annotatedPaths": [
    {
      object (AnnotatedPath)
    }
  ]
}
שדות
annotatedPaths[]

object (AnnotatedPath)

נתיבים מהקלט המסומן במאפיינים המבוקשים.

נתיב

נתיב שנשלחה בקשה לתכונות דינמיות.

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

כרגע המסלול מוגבל ל-15 ק"מ. הנתיב נמדד מתחילת הקטע הראשון, המיקום המשוער של הרכב. תוחזר שגיאה אם פלח בנתיב מתחיל במרחק של יותר מ-15 ק"מ מתחילת הקטע הראשון. מותר שהקטע האחרון יתחיל לפני 15 ק"מ ויסתיים אחרי 15 ק"מ. לא יוחזרו תשובות חלקיות.

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

ייצוג JSON 
{
  "segments": [
    {
      object (Segment)
    }
  ]
}
שדות
segments[]

object (Segment)

חובה. רשימה ממוינת של פלחים שיוצרים את הנתיב.

פילוח

פלח ששייך לנתיב.

ייצוג JSON 
{
  "polyline": {
    object (Polyline)
  },

  // Union field id can be only one of the following:
  "placeId": string
  // End of list of possible types for union field id.
}
שדות
polyline

object (Polyline)

חובה. הקו הפוליגוני של הפלח, שיכול לשמש לזיהוי הפלח אם לא ניתן למצוא את המזהה, וגם כדי להבחין בין שני פלחים אם יש להם אותו מזהה. הקו הפוליגוני מקודד באמצעות הפורמט הסטנדרטי של אלגוריתם מצולע מקודד בפלטפורמה של מפות Google.
שדה איחוד id. הנתונים משמשים לזיהוי הפלח הזה במרחב משותף עם מזהה. חובה. id יכול להיות רק אחד מהבאים:
placeId

string

מזהה המקום של קטע הדרך הזה. בשימוש בכל ממשקי API.

AnnotationOptions

ההערות המבוקשות לנתיבי הקלט.

ייצוג JSON 
{
  "includeLevelOfService": boolean
}
שדות
includeLevelOfService

boolean

זה שינוי אופציונלי. אם המדיניות מוגדרת כ-True, לפלחים בתגובה יהיו הערות עם ערכי תנועה חזויים. "רמת שירות" הוא מונח נפוץ לתיאור הסיווג של זרימת התנועה, אבל רמת הגדרות השירות ב-API הזה שייכת ל-API הזה בלבד.

AnnotatedPath

עותק של נתיב קלט שהוחזר עם מאפיינים חזויים.

ייצוג JSON 
{
  "annotatedSegments": [
    {
      object (AnnotatedSegment)
    }
  ]
}
שדות
annotatedSegments[]

object (AnnotatedSegment)

רשימה ממוינת של הפלחים שיוצרים את הנתיב הראשי, עם הערות לגבי המאפיינים המבוקשים.

AnnotatedSegment

פלח שיוצר נתיב עם הערות של מאפייני נתונים דינמיים.

ייצוג JSON 
{
  "segment": {
    object (Segment)
  },
  "segmentSpanAttributes": [
    {
      object (SegmentSpanAttribute)
    }
  ]
}
שדות
segment

object (Segment)

פרטי הפלחים שמשמשים להבחנה בין הפלחים האחרים.
segmentSpanAttributes[]

object (SegmentSpanAttribute)

מאפיינים שהוקצו לפלח. המאפיינים האלה עשויים להשתנות בהתאם לנתיב שבו נמצא הפלח. טווח עשוי לכסות את כל הקטע. טווחי המאפיינים יוצגו לפי הסדר ממיקום הרכב עד לסוף הנתיב.

SegmentSpanAttribute

פלח AttributeSpanAttribute מכיל את ההערות שהוחזרו מה-API.

ייצוג JSON 
{
  "segmentSpan": {
    object (SegmentSpan)
  },
  "levelOfService": enum (LevelOfService)
}
שדות
segmentSpan

object (SegmentSpan)

מתאר את המיקום בקטע שההערות חלות עליו.
levelOfService

enum (LevelOfService)

רמת התנועה החזויה עבור טווח הקטע, המוגדרת לפי מהירויות התנועה הצפויות בקטע זה כשהרכב מגיע בתחילת הקטע.

SegmentSpan

משמש להפרדה בין קטע משנה של פלח. אם טווח מכסה את כל הקטע, startMeter יהיה 0 ו-endMeter יהיה אורך המקטע.

ייצוג JSON 
{
  "startMeters": integer,
  "endMeters": integer
}
שדות
startMeters

integer

כאשר תחילת הטווח היא נקודת ההתחלה של הקו הפוליגוני של הקטע.
endMeters

integer

כאשר קצה הטווח הוא נקודת ההתחלה של הקו הפוליגוני של הקטע.

LevelOfService

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

טיפוסים בני מנייה (enums)
LEVEL_OF_SERVICE_UNSPECIFIED ערך ברירת המחדל. המשמעות של הערך הזה היא שאין ערך זמין של תנועה חזויה.
LEVEL_OF_SERVICE_STOPPED התנועה נעצרת.
LEVEL_OF_SERVICE_STOP_AND_GO התנועה נעצרת ונעצרת.
LEVEL_OF_SERVICE_SLOW צפויה האטה, אבל לא צפויים פקקי תנועה.
LEVEL_OF_SERVICE_NORMAL מהירות רגילה, לא צפויה האטה.