다중선 인코딩은 경로 등 일련의 좌표를 단일 문자열로 저장할 수 있는 손실 압축 알고리즘입니다. 인코딩 프로세스는 base64 인코딩 스키마를 사용하여 바이너리 값을 ASCII 문자의 일련의 문자 코드로 변환합니다. 인코딩 프로세스에 대한 자세한 내용은 인코딩된 다중선 알고리즘 형식을 참고하세요.
computeRoutes 메서드 (REST)와 ComputeRoutes 메서드 (gRPC)는 모두 다중선으로 표시된 경로를 응답의 일부로 반환합니다. 이러한 API는 두 가지 유형의 폴리라인을 반환합니다.
기본 다중선 (기본값): 경로를 나타내지만 다중선에 삽입된 교통정보는 없습니다. 기본 다중선을 반환하는 요청에는 경로 기본 요율로 요금이 청구됩니다. Routes API의 결제에 대해 자세히 알아보기
교통정보 인식 다중선에는 경로상의 교통상황에 대한 정보가 포함됩니다. 교통상황은 다중선의 지정된 간격에 적용되는 속도 카테고리 (
NORMAL,SLOW,TRAFFIC_JAM)로 표현됩니다. 교통정보 인식 다중선에 대한 요청에는 경로 기본 요율로 요금이 청구됩니다. Routes API의 결제에 대해 자세히 알아보기 자세한 내용은 다중선 품질 구성을 참고하세요.
다중선에 대한 자세한 내용은 다음을 참조하세요.
- 다중선의 품질을 구성하는 방법에 대한 자세한 내용은 품질과 지연 시간 구성을 참고하세요.
- 인코딩된 다중선 알고리즘 형식에서는 다중선을 인코딩하는 알고리즘에 대해 설명합니다.
대화형 다중선 인코더 유틸리티를 사용하면 UI에서 인코딩된 다중선을 만들거나 지도에 표시할 다중선을 디코딩할 수 있습니다. 예를 들어 이 유틸리티를 사용하여 아래 코드로 만든 다중선을 디코딩합니다.
경로, 구간 또는 단계에 대한 기본 다중선 요청
다중선은 다중선 (REST) 또는 다중선 (gRPC) 객체로 표현됩니다. 경로, 구간 및 단계 수준에서 응답에 폴리라인을 반환할 수 있습니다.
응답 필드 마스크를 사용하여 반환할 다중선을 지정합니다.
경로 수준에서 응답 필드 마스크에
routes.polyline를 포함하여 응답에 다중선을 반환합니다.구간 수준에서
routes.legs.polyline를 포함하여 경로의 각 구간에 대한 응답에 다중선을 반환합니다.단계 수준에서
routes.legs.steps.polyline를 포함하여 구간의 각 단계에 대한 응답에 다중선을 반환합니다.
예를 들어 전체 경로, 각 구간, 각 구간의 다중선을 반환하는 방법은 다음과 같습니다.
curl -X POST -d '{
"origin":{
"address": "1600 Amphitheatre Parkway, Mountain View, CA"
},
"destination":{
"address": "24 Willie Mays Plaza, San Francisco, CA 94107"
},
"travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline,routes.legs.polyline,routes.legs.steps.polyline' \
'https://routes.googleapis.com/directions/v2:computeRoutes'
이 요청은 경로, 경로의 각 구간, 구간의 각 단계에 대한 다중선이 포함된 다음 응답을 반환합니다.
{
"routes": [
{
"legs": [
{
"polyline": {
"encodedPolyline": "ipkcFfich...@Bs@?A?O?SD{A@o@B}@I?qA?_AA_@@_@?"
}
},
"steps": [
{
"polyline": {
"encodedPolyline": "kclcF...@sC@YIOKI"
}
},
{
"polyline": {
"encodedPolyline": "wblcF~...SZSF_@?"
}
},
...
],
"distanceMeters": 56901,
"duration": "2420s",
"polyline": {
"encodedPolyline": "ipkcFfich...@Bs@?A?O?SD{A@o@B}@I?qA?_AA_@@_@?"
}
}
]
}
이 요청에는 출발지와 목적지만 포함되므로 반환된 경로에는 구간이 하나만 포함됩니다. 따라서 구간의 다중선과 경로의 다중선이 동일합니다.
요청에 중간 경유지를 추가하면 반환된 경로에 2개의 구간이 포함됩니다.
curl -X POST -d '{
"origin":{
"address": "1600 Amphitheatre Parkway, Mountain View, CA"
},
"destination":{
"address": "24 Willie Mays Plaza, San Francisco, CA 94107"
},
"intermediates": [
{ "address": "450 Serra Mall, Stanford, CA 94305, USA"},
],
"travelMode": "DRIVE",
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline,routes.legs.polyline' \
'https://routes.googleapis.com/directions/v2:computeRoutes'
이 요청은 각각 고유한 다중선이 있는 구간 두 개와 전체 경로의 다중선을 반환합니다.
{
"routes": [
{
"legs": [
{
"polyline": {
"encodedPolyline": "kclcFfqchV?A...?I@G?GAECCCEKICBAFG"
}
"steps": [
{
"polyline": {
"encodedPolyline": "kclcFfqch...YIOKI"
}
},
...
},
{
"polyline": {
"encodedPolyline": "ojmcFtethV?K...QOYQOGA?_@MUG[Ga@G"
}
"steps": [
{
"polyline": {
"encodedPolyline": "uypeFbo`jVgJq...PoBiC"
}
},
...
}
],
"distanceMeters": 68403,
"duration": "3759s",
"polyline": {
"encodedPolyline": "kclcFfqchV?A?CBKF[Ha...?GAECCCEKICBAFGJEBE"
}
}
]
}
다중선 인코딩 유형 구성
다중선 유형을 제어하려면 polylineEncoding 요청 옵션을 사용합니다.
polylineEncoding 속성은 다중선을 ENCODED_POLYLINE(기본값)(다중선 인코딩 알고리즘 사용) 또는 GEO_JSON_LINESTRING(GeoJSON LineString 형식 사용) 중 하나로 인코딩하는 방법을 지정합니다.
예를 들어 요청 본문에서 다음과 같습니다.
curl -X POST -d '{
"origin":{
"address": "1600 Amphitheatre Parkway, Mountain View, CA"
},
"destination":{
"address": "24 Willie Mays Plaza, San Francisco, CA 94107"
},
"travelMode": "DRIVE",
"polylineEncoding": "ENCODED_POLYLINE"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline,routes.legs.polyline' \
'https://routes.googleapis.com/directions/v2:computeRoutes'
교통정보 인식 다중선 요청
위에 표시된 예는 모두 교통 정보가 없는 다중선을 의미하는 기본 다중선을 반환합니다. 또한 다중선에 경로와 각 구간의 교통정보가 포함되도록 요청할 수도 있습니다.
교통정보를 인식하는 다중선에는 경로상의 교통상황에 대한 정보가 포함됩니다. 교통상황은 응답 다중선의 지정된 간격 동안 속도 카테고리(NORMAL, SLOW, TRAFFIC_JAM)로 표현됩니다. 간격은 시작 (포함) 및 종료 (제외) 다중선 점의 색인으로 정의됩니다.
예를 들어 다음 응답은 다중선 점 2와 4 사이의 NORMAL 교통량을 보여줍니다.
{
"startPolylinePointIndex": 2,
"endPolylinePointIndex": 4,
"speed": "NORMAL"
}
교통량 인식 다중선을 계산하도록 요청하려면 요청에서 다음 속성을 설정하세요.
트래픽 계산을 사용 설정하려면
extraComputations배열 필드를TRAFFIC_ON_POLYLINE로 설정합니다.travelMode를DRIVE또는TWO_WHEELER로 설정합니다. 다른 이동 수단을 요청하면 오류를 반환합니다.요청에
TRAFFIC_AWARE또는TRAFFIC_AWARE_OPTIMAL라우팅 환경설정을 지정합니다. 자세한 내용은 품질 및 지연 시간 구성을 참고하세요.응답 속성을 반환하도록 지정하는 응답 필드 마스크를 설정합니다.
경로 수준에서 응답 필드 마스크에
routes.travelAdvisory를 포함하여 응답의 모든 이동 정보를 반환합니다. 교통정보만 반환하려면routes.travelAdvisory.speedReadingIntervals를 지정합니다.구간 수준에서는
routes.legs.travelAdvisory를 포함하여 경로의 각 구간에 대한 응답에 모든 이동 정보를 반환합니다. 교통정보만 반환하려면routes.legs.travelAdvisory.speedReadingIntervals를 지정합니다.
curl -X POST -d '{
"origin":{
"address": "1600 Amphitheatre Parkway, Mountain View, CA"
},
"destination":{
"address": "24 Willie Mays Plaza, San Francisco, CA 94107"
},
"travelMode": "DRIVE",
"extraComputations": ["TRAFFIC_ON_POLYLINE"],
"routingPreference": "TRAFFIC_AWARE_OPTIMAL"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline,routes.legs.polyline,routes.travelAdvisory,routes.legs.travelAdvisory' \
'https://routes.googleapis.com/directions/v2:computeRoutes'
교통정보 인식 다중선의 응답 예
응답에서 교통정보 데이터는 다중선에 인코딩되며 RouteLegTravelAdvisory 객체 (각 구간) 및 RouteTravelAdvisory 객체 (경로)의 travelAdvisory 필드에 포함됩니다.
예를 들면 다음과 같습니다.
{
"routes": [
{
"legs": {
"polyline": {
"encodedPolyline": "}boeF~zbjVAg@EmB`GWHlD"
},
// Traffic data for the leg.
"travelAdvisory": {
"speedReadingIntervals": [
{
"endPolylinePointIndex": 1,
"speed": "NORMAL"
},
{
"startPolylinePointIndex": 1,
"endPolylinePointIndex": 2,
"speed": "SLOW"
},
{
"startPolylinePointIndex": 2,
"endPolylinePointIndex": 4,
"speed": "NORMAL"
}
]
}
},
"polyline": {
"encodedPolyline": "}boeF~zbjVAg@EmB`GWHlD"
},
// Traffic data for the route.
"travelAdvisory": {
"speedReadingIntervals": [
{
"endPolylinePointIndex": 1,
"speed": "NORMAL"
},
{
"startPolylinePointIndex": 1,
"endPolylinePointIndex": 2,
"speed": "SLOW"
},
{
"startPolylinePointIndex": 2,
"endPolylinePointIndex": 4,
"speed": "NORMAL"
}
]
}
}
]
}
RouteTravelAdvisory와 RouteLegTravelAdvisory에는 모두 교통 속도 정보가 포함된 speedReadingIntervals라는 배열 필드가 포함되어 있습니다. 배열의 각 객체는 SpeedReadingInterval (REST) 또는 SpeedReadingInterval(gRPC) 객체로 표현됩니다.
SpeedReadingInterval 객체에는 NORMAL, SLOW, TRAFFIC_JAM와 같은 경로 간격의 속도 판독이 포함됩니다. 객체의 전체 배열은 경로의
전체 다중선을 겹치지 않고 포함합니다. 지정된 간격의 시작 지점은 이전 간격의 종료 지점과 동일합니다.
모든 간격은 startPolylinePointIndex, endPolylinePointIndex, 상응하는 속도 카테고리로 설명됩니다.
proto3 관행에 따라 간격 내에 시작 색인이 없는 경우 색인 0에 해당합니다.
startPolylinePointIndex 및 endPolylinePointIndex 값이 항상 연속적이지는 않습니다. 예를 들면 다음과 같습니다.
{
"startPolylinePointIndex": 2,
"endPolylinePointIndex": 4,
"speed": "NORMAL"
}
이 경우 색인 2에서 색인 4까지의 교통 상황은 동일했습니다.
Maps SDK로 교통정보를 인식하는 다중선 렌더링
다중선 구간을 따라 맞춤 색상, 획, 패턴 등 Google 지도 SDK에서 제공하는 다양한 기능을 사용하여 지도에 교통량 인식 다중선을 표시하는 것이 좋습니다. 다중선 사용에 대한 자세한 내용은 Android용 다중선 기능 및 iOS용 다중선 기능을 참고하세요.
다중선 렌더링 예시
지도 SDK 사용자는 속도 카테고리와 다중선 렌더링 스키마 간에 맞춤설정된 매핑 로직을 정의할 수 있습니다. 예를 들어 지도에 'NORMAL' 속도는 굵은 파란색 선으로 표시하고 'SLOW' 속도는 굵은 주황색 선으로 표시할 수 있습니다.
다음 스니펫은 멜버른에서 퍼스까지의 최단 거리 보간을 파란색의 굵은 다중선으로 추가합니다. 자세한 내용은 모양 맞춤설정(Android) 및 다중선 맞춤설정(iOS)을 참고하세요.
Android
Java
Polyline line = map.addPolyline(new PolylineOptions()
.add(new LatLng(-37.81319, 144.96298), new LatLng(-31.95285, 115.85734))
.width(25)
.color(Color.BLUE)
.geodesic(true));
Kotlin
val line: Polyline = map.addPolyline(
PolylineOptions()
.add(LatLng(-37.81319, 144.96298), LatLng(-31.95285, 115.85734))
.width(25f)
.color(Color.BLUE)
.geodesic(true)
)
iOS
Objective-C
GMSMutablePath *path = [GMSMutablePath path]; [path addLatitude:-37.81319 longitude:144.96298]; [path addLatitude:-31.95285 longitude:115.85734]; GMSPolyline *polyline = [GMSPolyline polylineWithPath:path]; polyline.strokeWidth = 10.f; polyline.strokeColor = .blue; polyline.geodesic = YES; polyline.map = mapView;
Swift
let path = GMSMutablePath() path.addLatitude(-37.81319, longitude: 144.96298) path.addLatitude(-31.95285, longitude: 115.85734) let polyline = GMSPolyline(path: path) polyline.strokeWidth = 10.0 polyline.geodesic = true polyline.map = mapView