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)

요청된 속성으로 주석이 달린 입력의 경로입니다.

경로

동적 속성이 요청되는 경로입니다.

경로에는 연결되고 주행 가능한 세그먼트가 있어야 합니다. 경로의 구간은 논리적 경로를 따르는 것으로 가정되며, 입력 구간에서 경로를 찾을 수 없는 경우 오류가 반환됩니다. 예를 들어 경로의 세그먼트에 연결 엔드포인트가 없거나 경로가 비어 있으면 오류가 발생합니다.

경로는 현재 길이가 15km로 제한됩니다. 경로는 첫 번째 구간, 즉 가정된 차량 위치가 시작되는 지점부터 측정됩니다. 경로의 한 구간이 첫 번째 구간의 시작 지점에서 15km보다 더 멀리 떨어져 있는 경우 오류가 반환됩니다. 마지막 구간은 15km 이전에 시작해서 15km를 지나도 괜찮습니다. 부분 응답은 반환되지 않습니다.

경로는 다른 경로와 동일한 세그먼트를 포함할 수 있지만, 경로 내 다른 부분의 차이에 따라 세그먼트 주석에 다른 응답이 포함될 수도 있습니다.

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)

필수 항목입니다. ID를 찾을 수 없는 경우 세그먼트를 식별하고 ID가 동일한 두 세그먼트를 구분하는 데 사용되는 세그먼트의 다중선입니다. 다중선은 표준 Google Maps Platform 인코딩된 다중선 알고리즘 형식을 사용하여 인코딩됩니다.

통합 필드 id. ID 공간 내에서 이 세그먼트를 식별하는 데 사용됩니다. 필수 항목입니다. id은 다음 중 하나여야 합니다.
placeId

string

이 도로 구간의 장소 ID입니다. 여러 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

SegmentSpanAttribute는 API에서 반환된 주석을 포함합니다.

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 기능에 사용되는 예측 트래픽 버킷 값입니다. 이 API에서 반환하는 값은 독립적이며 다른 API에 대응하는 데 의존해서는 안 됩니다.

열거형
LEVEL_OF_SERVICE_UNSPECIFIED 기본값 이 값은 사용 가능한 예상 트래픽 값이 없음을 의미합니다.
LEVEL_OF_SERVICE_STOPPED 트래픽이 중지되었습니다.
LEVEL_OF_SERVICE_STOP_AND_GO 정차하고 출발합니다.
LEVEL_OF_SERVICE_SLOW 감속이 예상되지만 교통 체증은 없을 것으로 예상됩니다.
LEVEL_OF_SERVICE_NORMAL 정상 속도, 감속이 예상됩니다.