Routes API 개요

Routes API는 HTTPS 요청을 수락하고 - 두 위치 사이의 이상적인 경로 또는 거리와 이동을 반환합니다. 시간을 계산할 수 있습니다.

Routes API를 사용하는 이유

Routes API를 사용하면 정확한 경로 및 이동 정보를 얻을 수 있습니다. 대중교통 정보, 최신 교통정보 및 도로 상황, 경로 환경설정:

  • 다양한 운송 수단의 유형과 기능

  • 차량이 향하는 방향

  • 승차 또는 하차할 수 있는 도로변

  • 교통상황 및 도로 폐쇄

  • 위험한 지역 회피 또는 안전 픽업 제공과 같은 안전 문제 지역

  • 라우팅 요구사항 전반에서 지연 시간, 품질, 비용의 균형을 유지합니다. 요금 및 경로 메타데이터(시간, 거리 등), 연료 효율성

또한 방향:

  • 일련의 패키지를 픽업하도록 작업자 집합을 할당하는 최선의 방법

  • 패키지를 최종 배송으로 보낼 최적의 창고 결정 목적지

Routes API로 무엇을 할 수 있나요?

Routes API를 사용하면 두 가지 기본 카테고리의 라우팅을 얻을 수 있습니다. 있습니다.

  • 단일 또는 여러 목적지까지의 경로

  • 여러 출발지와 도착지 사이에 가능한 경로의 행렬입니다.

단일 또는 여러 목적지의 경로 가져오기

Routes API Compute Routes 메서드를 사용하면 두 위치 간을 계산할 수 있습니다.

  • 다양한 여행 방법에 대한 경로 보기 및 한 개 또는 여러 개의 대상 유형:

    • 대중교통, 운전, 오토바이 등 이동 수단 걷거나 자전거를 타는 경우

    • 가장 효율적인 순서로 작업을 수행하도록 최적화할 수 있는 일련의 경유지를 이동하게 됩니다.

  • 출발지, 목적지 및 경유지를 지정하는 다양한 방법:

    • 텍스트 문자열입니다. 예: "시카고, 일리노이", "다윈, NT, 오스트레일리아", '1800 Amphitheatre Parkway, Mountain View, CA 94043' 또는 'CWF6+FWX Mountain 캘리포니아 보기'

    • 장소 ID

    • 위도 및 경도 좌표(선택사항으로 차량 방향 포함)

  • 필요와 목표에 따라 경로 옵션을 세부 조정합니다.

  • 다음을 사용하여 필요한 데이터만 요청하여 지연 시간과 품질을 제어하세요. 불필요한 처리 시간을 피하는 데 도움이 되며 청구 요금을 요청할 수 있습니다 자세한 내용은 반환할 정보를 선택합니다.

가능한 경로의 행렬 가져오기

Routes API Compute Route Matrix 메서드는 여러 출발지와 목적지 사이의 추천 경로에 대한 정보 매트릭스 위치 및 예상 도착 시간 등의 정보가 표시됩니다. 경로를 기반으로 최적의 출발지와 목적지를 살펴봤습니다 다음과 같은 종류의 거리 데이터를 요청할 수 있습니다.

  • 선택한 이동 수단의 거리

  • 거리(킬로미터 또는 마일)

  • 교통체증 예상 이동 시간

거리 데이터를 사용하여 가장 효율적인 경로 지정 방법을 결정할 수 있습니다. 승객, 화물 또는 작업자를 운송하는 데 사용되는 여러 출발지 및 목적지의 있습니다.

전체 행렬이 완료되기 전에 응답 요소를 스트리밍할 수 있습니다. 응답 지연 시간을 단축합니다

다음을 사용하여 서버 측 요청당 여러 출발지와 목적지를 지정할 수 있습니다. 출발지 수 x 목적지 수 625까지.

Routes API의 작동 방식

Routes API에는 ComputeRoutes 및 ComputeRouteMatrix

ComputeRoutes

Routes API ComputeRoutes 메서드는 다음과 같은 HTTP POST 요청을 수락합니다. 요청 세부정보가 포함된 JSON 요청 본문입니다. 출처는 필수 항목입니다. destination, travelMode, 필드 마스크를 사용하여 반환할 필드를 지정합니다.

예

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

그런 다음 서비스는 요청된 경로를 계산하고 사용자가 지정한 필드를 반환합니다. 있습니다.

ComputeRouteMatrix

Routes API ComputeRouteMatrix는 요청 세부정보가 포함된 JSON 요청 본문입니다. 1개 이상의 값을 입력해야 합니다. 출발지, 2개 이상의 목적지, travelMode, 필드를 지정할 필드 마스크 반환합니다.

예

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

응답에는 모든 출발지의 조합에 대한 가능한 경로가 포함됩니다. 목적지 경유지가 포함됩니다.

리소스

다음 표에는 Routes API 및 해당 API가 반환하는 데이터

데이터 리소스 반환된 데이터 반환 형식
ComputeRoutes 경로의 경로, 구간 및 계단을 대체 경로와 함께 반환합니다. 확인할 수 있습니다 JSON
ComputeRouteMatrix 한 출발지 경유지에서 한 목적지까지의 경로 배열을 반환합니다. 경유지.

Routes API 사용 방법

1 설정하기 Google Cloud 프로젝트 설정부터 시작 안내에 따라 설정을 완료합니다.
2 경로 계산 및 응답 검토 자세한 내용은 경로 가져오기 및 경로 응답 검토를 참고하세요.
3 경로의 행렬 계산 및 응답 검토 자세한 내용은 경로 매트릭스 가져오기를 참고하세요. 및 경로 매트릭스 응답 검토를 참조하세요.

사용 가능한 클라이언트 라이브러리

Routes API에 사용할 수 있는 클라이언트 라이브러리 목록은 다음을 참조하세요. 클라이언트 라이브러리.

다음 단계