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

رقم تعريف المكان لهذا الجزء من الطريق. ويتم استخدامها في جميع واجهات برمجة التطبيقات.

AnnotationOptions

التعليقات التوضيحية المطلوبة لمسارات الإدخال.

تمثيل JSON 
{
  "includeLevelOfService": boolean
}
الحقول
includeLevelOfService

boolean

اختياريّ. وعند ضبطها على "صحيح"، ستتم إضافة تعليقات توضيحية إلى الشرائح في الردّ باستخدام قيم عدد الزيارات المتوقّعة. "مستوى الخدمة" هو مصطلح مستخدَم بشكل عام لوصف تصنيف تدفق الزيارات، إلا أنّ مستوى تعريفات الخدمة في واجهة برمجة التطبيقات هذه ينتمي إلى واجهة برمجة التطبيقات هذه وحدها.

AnnotatedPath

نسخة من مسار إدخال تم عرضها بسمات متنبأ بها.

تمثيل JSON 
{
  "annotatedSegments": [
    {
      object (AnnotatedSegment)
    }
  ]
}
الحقول
annotatedSegments[]

object (AnnotatedSegment)

قائمة مرتبة بالأجزاء التي تشكّل المسار الرئيسي، مع إضافة تعليقات توضيحية إليها بالسمات المطلوبة.

AnnotatedSegment

شريحة تنشئ مسارًا، مصحوبة بتعليقات توضيحية بسمات بيانات ديناميكية.

تمثيل JSON 
{
  "segment": {
    object (Segment)
  },
  "segmentSpanAttributes": [
    {
      object (SegmentSpanAttribute)
    }
  ]
}
الحقول
segment

object (Segment)

تفاصيل الشريحة المستخدمة لتمييزها عن الشرائح الأخرى.
segmentSpanAttributes[]

object (SegmentSpanAttribute)

السمات المخصصة للشريحة. قد تختلف هذه السمات بناءً على المسار الذي يوجد به المقطع. قد يغطي النطاق الجزء بأكمله. تكون امتدادات السمات بالترتيب الأمامي من موقع المركبة إلى نهاية المسار.

SegmentSpanAttribute

يحتوي SlideSpanAttribute على التعليقات التوضيحية التي يتم عرضها من واجهة برمجة التطبيقات.

تمثيل JSON 
{
  "segmentSpan": {
    object (SegmentSpan)
  },
  "levelOfService": enum (LevelOfService)
}
الحقول
segmentSpan

object (SegmentSpan)

يصف مكان تطبيق التعليقات التوضيحية في الشريحة.
levelOfService

enum (LevelOfService)

مستوى عدد الزيارات المتوقّع لنطاق الجزء، والذي يتم تحديده من خلال سرعات حركة المرور المتوقعة في هذا الجزء عندما تصل المركبة إلى بداية الجزء.

SegmentSpan

تُستخدَم لتحديد قسم فرعي من أي شريحة. إذا كان مدى الامتداد يغطي الجزء بأكمله، فإن مقاييس startMeters ستكون 0 وendMeters هو طول الجزء.

تمثيل JSON 
{
  "startMeters": integer,
  "endMeters": integer
}
الحقول
startMeters

integer

أين تقع بداية النطاق من نقطة بداية الخطوط المتعددة للمقطع.
endMeters

integer

تقع نهاية النطاق من نقطة بداية الخطوط المتعددة للجزء.

LevelOfService

قيم مجموعات بيانات الزيارات المتوقَّعة التي تُستخدَم لوظيفة ADAS، والتي يتم ربطها بالمستويات العامة لعدد الزيارات. القيم التي تعرضها واجهة برمجة التطبيقات هذه مستقلة ولا يجب الاعتماد عليها لتتوافق مع واجهات برمجة التطبيقات الأخرى.

عمليات التعداد
LEVEL_OF_SERVICE_UNSPECIFIED القيمة التلقائية. وهذه القيمة تعني عدم توفّر قيمة متوقّعة لعدد الزيارات.
LEVEL_OF_SERVICE_STOPPED حركة المرور متوقفة.
LEVEL_OF_SERVICE_STOP_AND_GO كثافة حركة المرور متوقفة.
LEVEL_OF_SERVICE_SLOW من المتوقع حدوث بطء في حركة المرور، ولكن من غير المتوقع حدوث ازدحام مروري.
LEVEL_OF_SERVICE_NORMAL السرعة العادية، غير متوقَّعة، أي بطء في الأداء.