- HTTP 요청
- 요청 본문
- 응답 본문
- 경로
- 분류 기준
- AnnotationOptions
- AnnotatedPath
- AnnotatedSegment
- SegmentSpanAttribute
- SegmentSpan
- LevelOfService
경로와 함께 동적 속성에 대한 주석과 함께 입력 세그먼트 기반 경로를 반환합니다.
HTTP 요청
POST https://routes.googleapis.com/annotations/v2:annotatePaths
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "paths": [ { object ( |
입력란 | |
---|---|
paths[] |
필수 항목입니다. 동적 속성 데이터로 채워질 요청된 경로입니다. 모든 경로의 시작 구간은 차량이 현재 있는 구간이 같아야 합니다. 차량이 첫 번째 구간의 시작 부분에 있는 것으로 가정합니다. 경로가 동일한 세그먼트에서 시작되지 않으면 오류가 반환됩니다. |
annotationOptions |
필수 항목입니다. 입력 경로에 추가되어야 하는 요청된 동적 데이터 속성입니다. 비어 있으면 요청에 주석이 지정되지 않습니다. |
응답 본문
AnnotatePathsResponse에는 모든 요청된 주석에 대해 추가된 데이터가 있는 입력 경로가 포함됩니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"annotatedPaths": [
{
object ( |
입력란 | |
---|---|
annotatedPaths[] |
요청된 속성으로 주석이 달린 입력의 경로입니다. |
경로
동적 속성이 요청되는 경로입니다.
경로에는 연결되고 주행 가능한 세그먼트가 있어야 합니다. 경로의 구간은 논리적 경로를 따르는 것으로 가정되며, 입력 구간에서 경로를 찾을 수 없는 경우 오류가 반환됩니다. 예를 들어 경로의 세그먼트에 연결 엔드포인트가 없거나 경로가 비어 있으면 오류가 발생합니다.
경로는 현재 길이가 15km로 제한됩니다. 경로는 첫 번째 구간, 즉 가정된 차량 위치가 시작되는 지점부터 측정됩니다. 경로의 한 구간이 첫 번째 구간의 시작 지점에서 15km보다 더 멀리 떨어져 있는 경우 오류가 반환됩니다. 마지막 구간은 15km 이전에 시작해서 15km를 지나도 괜찮습니다. 부분 응답은 반환되지 않습니다.
경로는 다른 경로와 동일한 세그먼트를 포함할 수 있지만, 경로 내 다른 부분의 차이에 따라 세그먼트 주석에 다른 응답이 포함될 수도 있습니다.
JSON 표현 |
---|
{
"segments": [
{
object ( |
입력란 | |
---|---|
segments[] |
필수 항목입니다. 경로를 형성하는 세그먼트의 순서가 지정된 목록입니다. |
세그먼트
경로에 속한 세그먼트입니다.
JSON 표현 |
---|
{ "polyline": { object ( |
입력란 | |
---|---|
polyline |
필수 항목입니다. ID를 찾을 수 없는 경우 세그먼트를 식별하고 ID가 동일한 두 세그먼트를 구분하는 데 사용되는 세그먼트의 다중선입니다. 다중선은 표준 Google Maps Platform 인코딩된 다중선 알고리즘 형식을 사용하여 인코딩됩니다. |
통합 필드 id . ID 공간 내에서 이 세그먼트를 식별하는 데 사용됩니다. 필수 항목입니다. id 은 다음 중 하나여야 합니다. |
|
placeId |
이 도로 구간의 장소 ID입니다. 여러 API에서 사용됩니다. |
AnnotationOptions
입력 경로의 요청된 주석입니다.
JSON 표현 |
---|
{ "includeLevelOfService": boolean } |
입력란 | |
---|---|
includeLevelOfService |
선택사항입니다. true로 설정하면 응답의 세그먼트에 예상 트래픽 값이 주석으로 추가됩니다. '서비스 수준'은 일반적으로 트래픽 흐름의 분류를 설명하는 데 사용되는 용어이지만 이 API에서 서비스 정의 수준은 이 API에만 속합니다. |
AnnotatedPath
예측된 속성과 함께 반환된 입력 경로의 사본입니다.
JSON 표현 |
---|
{
"annotatedSegments": [
{
object ( |
입력란 | |
---|---|
annotatedSegments[] |
기본 경로를 형성하며 요청된 속성이 추가된 세그먼트의 순서가 지정된 목록입니다. |
AnnotatedSegment
동적 데이터 속성으로 주석이 달린 경로를 만드는 세그먼트입니다.
JSON 표현 |
---|
{ "segment": { object ( |
입력란 | |
---|---|
segment |
다른 세그먼트와 구별하기 위해 사용되는 세그먼트 세부정보입니다. |
segmentSpanAttributes[] |
세그먼트에 할당된 속성입니다. 이러한 속성은 세그먼트가 있는 경로에 따라 다를 수 있습니다. 스팬은 전체 세그먼트를 포함할 수 있습니다. 속성 스팬은 차량 위치에서 경로 끝까지 순서입니다. |
SegmentSpanAttribute
SegmentSpanAttribute는 API에서 반환된 주석을 포함합니다.
JSON 표현 |
---|
{ "segmentSpan": { object ( |
입력란 | |
---|---|
segmentSpan |
세그먼트에서 주석이 적용되는 위치를 나타냅니다. |
levelOfService |
구간 범위의 예상 교통량으로, 차량이 구간 시작 부분에 도착할 때 이 구간에서 예상되는 통행 속도로 정의됩니다. |
SegmentSpan
세그먼트의 하위 섹션을 구분하는 데 사용됩니다. 스팬이 전체 세그먼트를 포함하는 경우 startMeters는 0이고 endMeters는 세그먼트 길이가 됩니다.
JSON 표현 |
---|
{ "startMeters": integer, "endMeters": integer } |
입력란 | |
---|---|
startMeters |
여기에서 스팬의 시작은 선분 다중선의 시작점에서 시작됩니다. |
endMeters |
스팬의 끝은 선분 다중선의 시작점에서 시작됩니다. |
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 |
정상 속도, 감속이 예상됩니다. |