Compute Routes 개요

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

소개

Compute Routes는 HTTPS 요청을 수락하고 두 위치 간의 최적 경로를 반환하는 Routes API 서비스의 메서드입니다. 여러 위치 간의 대중교통, 자전거, 운전, 이륜차 또는 도보 경로를 실시간 교통정보를 기반으로 제공하세요.

경로 매트릭스가 필요하신가요? 경로 매트릭스에 관심이 있다면 Compute Route Matrix 개요를 참고하세요.

이전하시나요? Distance Matrix API (기존)에서 마이그레이션하는 경우 Routes API로 마이그레이션해야 하는 이유로 시작하는 마이그레이션 안내를 참고하세요.

Compute Routes를 사용하는 이유

Compute Routes를 사용하면 다양한 경로 세부정보를 통해 비용과 품질을 최적화하면서 선호도에 따라 차량이나 패키지를 라우팅할 수 있습니다.

Compute Routes로 할 수 있는 작업

Routes API Compute Routes 메서드를 사용하면 다음 작업을 할 수 있습니다.

  • 다양한 이동 수단, 단일 또는 여러 목적지에 대한 경로를 확인합니다.

    • 이동 수단: 대중교통, 자동차, 이륜차, 도보 또는 자전거

    • 이동할 가장 효율적인 순서로 최적화할 수 있는 일련의 경유지입니다.

  • 다양한 방법으로 출발지, 도착지, 경유지 지정:

    • 텍스트 문자열입니다. 예: 'Chicago, IL', 'Darwin, NT, Australia', '1800 Amphitheatre Parkway, Mountain View, CA 94043', 'CWF6+FWX Mountain View, California'

    • 장소 ID

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

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

  • 필드 마스크를 사용하여 필요한 데이터만 요청하면 지연 시간과 품질을 제어할 수 있으며, 불필요한 처리 시간과 높은 요청 요금 청구율을 방지할 수 있습니다. 자세한 내용은 반환할 정보 선택하기를 참고하세요.

Compute Routes 작동 방식

Routes API ComputeRoutes 메서드는 요청 세부정보가 포함된 JSON 요청 본문이 있는 HTTP POST 요청을 허용합니다. 출발지, 목적지, 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'

그런 다음 서비스는 요청된 경로를 계산하고 요청한 필드를 반환합니다.

리소스

다음 표에는 Routes API Compute Routes 메서드를 통해 사용할 수 있는 리소스와 반환되는 데이터가 요약되어 있습니다.

데이터 리소스 반환된 데이터 반환 형식
ComputeRoutes 요청된 경우 대체 경로와 함께 경로의 경로, 구간, 단계를 반환합니다. JSON

Compute Routes 사용 방법

1 설정하기 Google Cloud 프로젝트 설정하기로 시작하여 다음에 나오는 설정 안내를 완료합니다.
2 Routes API 청구 방식 이해하기 자세한 내용은 사용량 및 결제를 참고하세요.
3 경로 계산 및 응답 검토 자세한 내용은 경로 가져오기 및 경로 응답 검토하기를 참고하세요.

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

컴퓨트 경로에 사용할 수 있는 클라이언트 라이브러리 목록은 클라이언트 라이브러리를 참고하세요.

다음 단계