더 짧은 경로를 찾습니다.

유럽 경제 지역 (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의 결제에 대해 자세히 알아보세요.