Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

더 짧은 경로를 찾습니다.

유럽 경제 지역 (EEA) 개발자

Compute Routes는 더 짧은 거리 경로를 사용 설정하면 더 짧은 이동 거리에 최적화된 운전 경로를 반환할 수 있습니다.

더 짧은 거리 경로를 요청하면 서비스는 다음을 반환합니다.

기본 경로: 주로 ETA에 최적화된 경로입니다.
전체 이동에서 이동 거리를 최소화하도록 최적화된 더 짧은 경로입니다.

정의 및 사용 이유

거리가 짧은 경로에서는 운전 편의성이나 속도보다 거리를 우선시합니다. 예를 들어 고속도로 대신 지역 도로를 선호하거나, 비포장 도로를 이용하거나, 주차장을 통과할 수 있습니다. Google 지도에서 불법으로 인식하는 이동은 반환하지 않습니다.

더 짧은 거리의 경로 요청

요청은 다음 기준을 충족해야 합니다.

travelMode을 DRIVE, BICYCLE 또는 TWO_WHEELER로 설정합니다.
requestedReferenceRoutes를 SHORTER_DISTANCE로 설정합니다.
응답 필드 마스크를 설정하여 더 짧은 거리 경로와 연결된 응답 속성을 반환합니다.
- routes.routeLabels: 각 경로를 DEFAULT_ROUTE, SHORTER_DISTANCE 또는 DEFAULT_ROUTE_ALTERNATE로 식별합니다.
- routes.routeToken: Navigation SDK에 전달하여 맞춤 경로를 가져올 수 있는 경로 토큰입니다.
Via 중간 경유지는 포함하지 마세요.
optimizeWaypointOrder 매개변수를 포함하지 마세요.
선택사항: 기본 경로와 단거리 경로 모두와 연결된 다음 속성을 반환하도록 응답 필드 마스크를 설정합니다.
- routes.distanceMeters: 경로의 거리를 반환합니다.
- routes.duration: 경로의 기간을 반환합니다.

참조 정보는 ReferenceRoute 및 RouteLabel을 참고하세요.

요청 예: 더 짧은 거리의 경로

다음 코드는 더 짧은 거리 경로를 요청하는 방법을 보여줍니다. 이 예에서는 응답 필드 마스크를 사용하여 다음 필드 마스크로 기본 경로와 단거리 경로 모두와 연결된 필드를 반환합니다.

routes.distanceMeters
routes.duration

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "requestedReferenceRoutes": ["SHORTER_DISTANCE"],
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

더 짧은 경로 응답 예시

{
  "routes": [
    {
      "distanceMeters": 138943,
      "duration": "5373s",
      "routeToken": "CrsCCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXcklWWFo2cjhDZmltdk9NUDQ3aU1nUU0QBRpPCk0KGAoNCgIIAREAAAAAAIBmQBF56SYxqDm4QBISCAAQAxAGEBMQEhgCQgQaAggFIhsKF3JJVlhaLWFOQnZpbXZPTVA0N2lNZ1FNcAEoASIVAACBmRY1BjeCiUQewJGTrQ3DuHRp",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 112610,
      "duration": "7165s",
      "routeToken": "CqgCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdySVZYWjZHR0RiTzV2T01QOUpiQXlBTRAFGk8KTQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhIIABADEAYQExASGAJCBBoCCAUiGwoXcklWWFo3S09Cck81dk9NUDlKYkF5QU1wASgCIhUAAIGZFlj_CmMgGE6KGZcsE-tEywM",
      "routeLabels": [
        "SHORTER_DISTANCE"
      ]
    }
  ]
}

요청 예시: 최단 거리 및 연비 최적 경로

다음 코드는 최단 거리 경로와 연비 최적 경로를 모두 요청하는 것을 보여줍니다.

 curl -X POST -d '{
"origin": {  "location": {  "latLng": {  "latitude": 41.76904801292959,
"longitude": -72.67374935684933  }  }  },  "destination": {  "location": {
"latLng": {  "latitude": 41.823042361105024,  "longitude": -71.40933143059424  }
 }  },  "travelMode":"DRIVE",  "routingPreference":"TRAFFIC_AWARE_OPTIMAL",
"requestedReferenceRoutes": ["SHORTER_DISTANCE", "FUEL_EFFICIENT"] }' 

-H 'Content-Type: application/json' 

-H 'X-Goog-Api-Key: YOUR_API_KEY' 

-H 'X-Goog-FieldMask:
routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' 

'https://routes.googleapis.com/directions/v2:computeRoutes'

응답 예시: 최단 거리 및 연비 최적 경로

이 경우 거리가 짧은 경로와 연비 최적 경로가 동일하므로 해당 경로가 반환되고 두 유형의 경로 모두에 routeLabel가 포함됩니다.

{  "routes": [  {  "distanceMeters": 138943,  "duration": "5375s",
"routeToken":
"Cr8CCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXS1laWFo4T19JcWVCM2ZFUDFMbms4UXcQBRpTClEKGAoNCgIIAREAAAAAAIBmQBFOYhBYGTy4QBIWCAAQAxAGEBMQEhgCQgQaAggFSgIIASIbChdLWVpYWjlpV0g2ZUIzZkVQMUxuazhRd3ABKAEiFQAAgZkW4Df4cspNNJZWlMZuUUxLPQ",
 "routeLabels": [  "DEFAULT_ROUTE"  ]  },  {  "distanceMeters": 112610,
"duration": "7156s",  "routeToken":
"CqwCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdLWVpYWi1UNklfT055OVlQczhhcWlRSRAFGlMKUQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhYIABADEAYQExASGAJCBBoCCAVKAggBIhsKF0tZWlhaNERXSF9PTnk5WVBzOGFxaVFJcAEoAiIVAACBmRaESp2EJS5nmwiEF8KH15_f",
 "routeLabels": [  "FUEL_EFFICIENT",  "SHORTER_DISTANCE"  ]  }  ] }

지원되는 리전

단거리 경로가 모든 지역에서 지원됩니다.

결제

Google Maps Platform은 실험용 기능 사용에 대해 추가 요금을 청구하지 않습니다. 설정한 다른 매개변수를 기반으로 API 사용량에 따라 요금이 청구됩니다.

Routes API의 결제에 대해 자세히 알아보세요.