더 짧은 경로를 찾습니다.

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

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

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

정의 및 사용 이유

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

더 짧은 거리의 경로 요청

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

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

참조 정보는 ReferenceRouteRouteLabel을 참고하세요.

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

다음 코드는 더 짧은 거리의 경로를 요청하는 것을 보여줍니다. 이 예에서는 응답 필드 마스크를 사용하여 다음 필드 마스크와 함께 기본 경로와 더 짧은 경로와 관련된 필드를 반환합니다.

  • 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의 결제에 대해 자세히 알아보세요.