모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Maps Distance Matrix API 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Maps Distance Matrix API 활성화
  3. 적합한 키 생성
계속

개발자 가이드

Google Maps Distance Matrix API는 출발지와 목적지 매트릭스에 대한 이동 거리와 시간을 제공하는 서비스입니다.

이 서비스는 또한 클라이언트측 Google Maps JavaScript API의 일부로 제공되거나 서버측에서 Java Client, Python Client, Go Client 및 Node.js Client for Google Maps Services와 함께 사용됩니다. 참고: 서비스 사용 방법에 상관없이 동일한 일일 사용 제한이 적용됩니다. 허용되는 일일 요소 수는 클라이언트측 쿼리와 서버측 쿼리의 합계로 계산합니다.

이 문서는 한 Google Maps API가 제공하는 지도에서 수많은 지점 간 이동 거리 및 시간을 계산하려는 개발자를 대상으로 합니다. 이 문서에서는 API 사용 방법과 사용 가능한 매개변수에 대한 참조 자료를 소개합니다.

소개

Google Maps Distance Matrix API는 Google Maps API에 의해 계산된 시작 지점과 끝 지점 사이의 추천 경로에 기반한 정보를 반환하며, 각 쌍에 대해 durationdistance 값을 포함하는 여러 행으로 구성됩니다.

이 서비스는 상세 경로 정보를 반환하지 않습니다. 원하는 단일 출발지와 목적지를 Google Maps Directions API로 전달하여 경로 정보를 구할 수 있습니다.

Distance Matrix API 개발을 시작하기 전에 인증 요구사항(API 키 필요) 및 API 사용 제한을 검토하세요.

거리 행렬 요청

Google Maps Distance Matrix API 요청의 형식은 다음과 같습니다.

https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters

여기서 outputFormat은 다음 값 중 하나일 수 있습니다.

  • json(권장): JSON(JavaScript Object Notation) 형식으로 출력을 나타냅니다.
  • xml: XML 형식으로 출력을 나타냅니다.

참고: URL은 유효하도록 적절하게 인코딩해야 하며 모든 웹 서비스에 대해 8192자로 제한됩니다. URL을 구성할 때 이 제한을 알아야 합니다. 참고로 브라우저, 프록시 및 서버가 다르면 URL 문자 제한도 다를 수 있습니다.

HTTPS 또는 HTTP

보안은 중요하므로 특히 사용자 위치와 같은 민감한 사용자 데이터를 요청에 포함하는 애플리케이션의 경우, 가급적 HTTPS를 사용하는 것이 좋습니다. HTTPS 암호화를 사용하면 애플리케이션의 보안이 강화되고 스누핑이나 변조에 대한 저항력도 강화됩니다.

HTTPS를 사용할 수 없는 경우 HTTP를 통해 Google Maps Distance Matrix API에 액세스하려면 다음을 사용합니다.

http://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters

요청 매개변수

일부 매개변수는 필수인 반면 일부 매개변수는 선택 사항입니다. URL 표준 형식과 마찬가지로, 모든 매개변수는 앰퍼샌드(&) 문자를 사용하여 구분합니다.

필수 매개변수

  • origins — 이동 거리 및 시간을 계산하는 시작 지점. 파이프 문자(|)로 구분된 한 개 이상의 위치를 주소, 위도/경도 좌표 또는 장소 ID의 형식으로 제공할 수 있습니다.
    • 주소를 전달하는 경우 이 서비스는 해당 문자열을 지오코딩하고 위도/경도 좌표로 변환하여 거리를 계산합니다. 이 좌표는 Google Maps Geocoding API에서 반환되는 좌표와 다를 수도 있습니다(예: 건물 중심이 아니라 건물 입구).
      origins=Bobcaygeon+ON|24+Sussex+Drive+Ottawa+ON
    • 위도/경도 좌표를 전달하는 경우 해당 좌표를 변경 없이 사용하여 거리를 계산합니다. 위도와 경도 값 사이에 공백이 없도록 하십시오.
      origins=41.43206,-81.38992|-33.86748,151.20699
    • 장소 ID를 제공하는 경우 place_id:라는 접두사를 붙여야 합니다. 요청이 API 키 또는 Google Maps API 프리미엄 플랜 클라이언트 ID를 포함하는 경우에는 장소 ID만 지정할 수 있습니다. Google Maps Geocoding API 및 Google Places API(장소 자동완성 포함)에서 장소 ID를 검색할 수 있습니다. 장소 자동완성에서 장소 ID를 사용하는 예는 장소 자동완성 및 길찾기를 참조하세요. 장소 ID에 대한 자세한 내용은 장소 ID 개요를 참조하세요.
      origins=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE
    • 또는 인코딩된 폴리라인 알고리즘을 사용하여 인코딩된 좌표 집합을 제공할 수 있습니다. 이는 인코딩된 폴리라인을 사용하는 경우 URL이 훨씬 짧으므로 원점이 많은 경우에 특히 유용합니다.
      • 인코딩된 폴리라인은 enc:라는 접두사와 그 뒤에 콜론(:)을 사용해야 합니다(예: origins=enc:gfo}EtohhU:).
      • 또한 파이프 문자(|)로 구분된 복수의 인코딩된 폴리라인을 포함할 수도 있습니다. 예: origins=enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:|enc:udymA{~bxM:
  • destinations — 이동 거리 및 시간을 계산하기 위한 끝 지점으로 사용할 한 개 이상의 위치입니다. destinations 매개변수의 옵션은 위에서 설명한 origins 매개변수의 옵션과 동일합니다.
  • key — 애플리케이션의 API 키. 이 키는 할당량 관리를 위해 애플리케이션을 식별합니다. 키 가져오기 방법에 대해 알아봅니다.

    참고: Google Maps API 프리미엄 플랜 고객은 Distance Matrix 요청에서 API 키를 사용하거나 유효한 클라이언트 ID와 디지털 서명을 사용할 수 있습니다. 자세한 내용은 프리미엄 플랜 고객의 인증 매개변수를 참조하세요.

다음 예시는 위도/경도 좌표를 사용하여 대상 좌표를 지정합니다.

https://maps.googleapis.com/maps/api/distancematrix/json?units=imperial&origins=40.6655101,-73.89188969999998&destinations=40.6905615%2C-73.9976592%7C40.6905615%2C-73.9976592%7C40.6905615%2C-73.9976592%7C40.6905615%2C-73.9976592%7C40.6905615%2C-73.9976592%7C40.6905615%2C-73.9976592%7C40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626%7C40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626&key=YOUR_API_KEY

다음 예시는 인코딩된 폴리라인을 사용하여 동일한 요청을 보여줍니다.

https://maps.googleapis.com/maps/api/distancematrix/json?units=imperial&origins=40.6655101,-73.89188969999998&destinations=enc:_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV:&key=YOUR_API_KEY

선택적 매개변수

  • mode(기본값은 driving) — 거리를 계산할 때 사용할 전송 모드를 지정합니다. 유효한 값과 기타 요청 세부정보는 이 문서의 이동 모드 섹션에서 지정됩니다.
  • language — 결과 반환 시 사용되는 언어.
    • 지원되는 언어 목록을 참조하세요. 지원되는 언어는 자주 업데이트되므로 목록이 완전하지 않을 수 있습니다.
    • language를 지정하지 않으면 API는 Accept-Language 헤더에 지정된 기본 언어를 사용하거나 요청을 보낸 도메인의 기본 언어를 사용하려고 시도합니다.
    • API는 사용자와 현지인이 모두 읽을 수 있는 거리 주소를 제공하려고 최선을 다합니다. 이를 위해 API는 기본 언어를 준수하면서 필요한 경우 사용자가 읽을 수 있는 스크립트로 음차한 현지 언어로 거리 주소를 반환합니다. 다른 모든 주소는 기본 언어로 반환됩니다. 주소 구성 요소는 모두 첫 번째 구성 요소에서 선택한 동일한 언어로 반환됩니다.
    • 기본 언어로 이름을 사용할 수 없는 경우 API는 가장 유사한 일치 항목을 사용합니다.
    • 기본 언어는 API가 반환하려고 선택한 결과 집합과 반환 순서에 약간의 영향을 미칩니다. 지오코더는 언어에 따라 유효하거나 유효하지 않을 수 있는 동의어 또는 거리 유형에 대한 약어와 같이 언어에 따라 다르게 약어를 해석합니다. 예를 들어, utcatér는 헝가리어로 거리에 대한 동의어입니다.
  • avoid — 경로에 제한을 적용합니다. 유효한 값은 이 문서의 제한 섹션에서 지정됩니다. 하나의 제한만을 지정할 수 있습니다.
  • units — 거리를 텍스트로 표현할 때 사용할 단위 체계를 지정합니다. 자세한 내용은 이 문서의 단위 체계 섹션을 참조하세요.
  • arrival_time — 대중교통 요청의 경우 1970년 1월 1일 자정(UTC) 이후의 원하는 도착 시간을 초 단위로 지정합니다. departure_time 또는 arrival_time을 지정할 수 있지만, 둘 모두를 지정할 수는 없습니다. 참고로, arrival_time은 정수로 지정되어야 합니다.
  • departure_time — 원하는 출발 시간. 1970년 1월 1일 자정(UTC) 이후의 시간을 초 단위의 정수로 지정할 수 있습니다. 또는, now 값을 지정할 수 있습니다. 이 값은 출발 시간을 현재 시간(가장 가까운 초로 보정)으로 설정합니다. 출발 시간은 다음 두 경우에 지정될 수 있습니다.
    • 이동 모드가 대중교통인 요청의 경우: departure_time 또는 arrival_time 중 하나를 선택적으로 지정할 수 있습니다. 둘 다 지정되지 않은 경우 departure_time은 기본적으로 now입니다. (즉, 출발 시간은 기본적으로 현재 시간이 됩니다.)
    • 이동 모드가 자동차인 요청의 경우: 교통 상황을 고려하여 경로와 이동 시간(응답 필드: duration_in_traffic)을 수신하려면 departure_time을 지정할 수 있습니다. 이 옵션은 올바른 API 키나 올바른 Google Maps API 프리미엄 플랜 클라이언트 ID 및 서명이 포함된 요청에만 사용할 수 있습니다. departure_time은 현재 시간 또는 미래의 특정 시간으로 설정되어야 합니다. 이 시간은 과거가 될 수 없습니다.

      참고: mode=driving인 경우 departure_time을 지정하는 거리 행렬 요청은 요청당 최대 100개의 요소로 제한됩니다. origins 수와 destinations 수의 곱은 요소의 수를 정의합니다.

  • traffic_model(기본값 best_guess) — 교통량을 고려한 시간을 계산할 때 사용할 가정을 지정합니다. 이 설정은 응답에서 duration_in_traffic 필드에 반환되는 값에 영향을 미치며, 여기에는 과거의 평균 교통량에 따른 예상 시간이 포함됩니다. traffic_model 매개변수는 이동 모드가 driving인 요청, departure_time이 포함된 요청 또는 API 키 또는 Google Maps API 프리미엄 플랜 클라이언트 ID가 포함된 요청에만 지정될 수 있습니다. 이 매개변수에 사용 가능한 값은 다음과 같습니다.
    • best_guess(기본값)는 과거의 교통 상황과 실시간 교통량을 모두 알고 있을 때, 반환된 duration_in_traffic이 최적의 예상 이동 시간임을 나타냅니다. 실시간 교통량은 departure_time이 현재에 더 가까울수록 더 중요해 집니다.
    • pessimistic은 반환된 duration_in_traffic이 평소의 실제 이동 시간보다 더 긴 것을 나타내지만, 특히 교통 상황이 나쁜 날에는 이 값을 초과할 수도 있습니다.
    • optimistic은 반환된 duration_in_traffic이 평소의 실제 이동 시간보다 더 짧은 것을 나타내지만, 특히 교통 상황이 좋은 날에는 이 값보다 더 빨라질 수도 있습니다.
  • transit_mode — 선호하는 대중교통 모드를 하나 이상 지정합니다. 이 매개변수는 modetransit인 요청에만 지정될 수 있습니다. 매개변수는 다음과 같은 인수를 지원합니다.
    • bus는 계산된 경로가 버스 이동을 선호함을 나타냅니다.
    • subway는 계산된 경로가 지하철 이동을 선호함을 나타냅니다.
    • train은 계산된 경로가 기차 이동을 선호함을 나타냅니다.
    • tram은 계산된 경로가 전차와 경전철 이동을 선호함을 나타냅니다.
    • rail은 계산된 경로가 기차, 전차, 경전철 및 지하철 이동을 선호함을 나타냅니다. 이는 transit_mode=train|tram|subway와 동등합니다.
  • transit_routing_preference — 대중교통 요청에 대한 기본 설정을 지정합니다. 이 매개변수를 사용하면, API에 의해 선택되는 기본 최적 경로를 수락하는 대신, 반환되는 옵션을 편중할 수 있습니다. 이 매개변수는 modetransit인 요청에만 지정될 수 있습니다. 매개변수는 다음과 같은 인수를 지원합니다.
    • less_walking은 계산된 경로가 제한된 도보량을 선호함을 나타냅니다.
    • fewer_transfers는 계산된 경로가 제한된 환승 횟수를 선호함을 나타냅니다.

이동 모드

거리를 계산할 때, 사용할 이동 mode를 지정해야 할 수 있습니다. 기본적으로, 자동차 모드에 대한 거리가 계산됩니다. 다음과 같은 이동 모드가 지원됩니다.

  • driving(기본값)은 도로망을 사용하는 거리 계산을 나타냅니다.
  • walking은 보행자 경로 및 인도(있는 경우)를 경유하는 거리 계산을 요청합니다.
  • bicycling은 자전거 경로 및 선호하는 거리(있는 경우)를 경유하는 거리 계산을 요청합니다.
  • transit은 대중교통 경로(있는 경우)를 경유하는 거리 계산을 요청합니다. 이 값은 요청에 API 키 또는 Google Maps API 프리미엄 플랜 클라이언트 ID가 포함된 경우에만 지정할 수 있습니다. 모드를 transit으로 설정하면, departure_time 또는 arrival_time을 선택적으로 지정할 수 있습니다. 둘 다 지정되지 않은 경우 departure_time은 기본적으로 now입니다. (즉, 출발 시간은 기본적으로 현재 시간이 됩니다.) 또한 transit_mode 및/또는 transit_routing_preference를 선택적으로 포함할 수 있습니다.

* 참고: 때로는 도보 및 자전거 경로에 불명확한 보행자 또는 자전거 경로가 포함될 수 있으므로, 이러한 응답에서는 반환 결과에 warnings를 반환하여 사용자에게 표시해야 합니다.

제한

특정한 제한을 준수하여 거리가 계산될 수도 있습니다. 제한은 avoid 매개변수와 이 매개변수의 인수를 사용하여 표시되며, 인수는 피하려는 제한을 나타냅니다. 다음과 같은 제한이 지원됩니다.

  • avoid=tolls
  • avoid=highways
  • avoid=ferries
  • avoid=indoor

* 참고: 제한을 더 추가하더라도 제한된 기능이 포함된 경로가 제외되는 것은 아니며, 더 나은 경로를 찾기 위해 결과를 편중할 뿐입니다.

단위 체계

거리 행렬 결과에는 계산된 경로의 거리를 나타내는 textdistance 필드 내에 포함됩니다. 사용할 단위 체계를 지정할 수 있습니다.

  • units=metric(기본값)은 킬로미터 및 미터 단위로 거리를 반환합니다.
  • units=imperial은 마일과 피트 단위로 거리를 반환합니다.

* 참고: 이 단위 체계 설정은 distance 필드 내에 표시되는 text에만 영향을 미칩니다. distance 필드는 항상 미터로 표현되는 values도 포함합니다.

거리 행렬 응답

Google Maps Distance Matrix API 쿼리에 대한 응답은 URL 요청 경로 내 output 플래그에서 표시한 형식으로 반환됩니다.

아래의 두 샘플 HTTP 요청에서는, 캐나다 BC 벤쿠버와 미국 WA 시애틀에서 미국 CA 샌프란시스코와 캐나다 BC 빅토리아까지의 소요 시간 및 거리를 요청합니다.

이 요청은 JSON output 플래그 사용을 보여줍니다.

https://maps.googleapis.com/maps/api/distancematrix/json?origins=Vancouver+BC|Seattle&destinations=San+Francisco|Victoria+BC&mode=bicycling&language=fr-FR&key=YOUR_API_KEY

이 요청은 XML output 플래그 사용을 보여줍니다.

https://maps.googleapis.com/maps/api/distancematrix/xml?origins=Vancouver+BC|Seattle&destinations=San+Francisco|Vancouver+BC&mode=bicycling&language=fr-FR&key=YOUR_API_KEY

이 요청은 2개의 출발지와 2개의 목적지를 곱한 다음 네 가지 요소를 반환합니다.

벤쿠버 - 샌프란시스코 벤쿠버 - 빅토리아
시애틀 - 샌프란시스코 시애틀 - 빅토리아

결과는 행으로 반환되며, 각 행에는 하나의 출발지와 각 목적지가 쌍으로 포함됩니다.

체험해 보세요! 브라우저에서 샘플 요청을 보내려면 여기를 클릭하세요. (파일 열기에 사용할 애플리케이션을 선택하라는 메시지가 나타나면, 자신의 브라우저나 선호하는 텍스트 편집기를 선택할 수 있습니다.)

아래의 탭을 클릭하여 샘플 JSON 및 XML 응답을 살펴보세요.

JSON
{
  "status": "OK",
  "origin_addresses": [ "Vancouver, BC, Canada", "Seattle, État de Washington, États-Unis" ],
  "destination_addresses": [ "San Francisco, Californie, États-Unis", "Victoria, BC, Canada" ],
  "rows": [ {
    "elements": [ {
      "status": "OK",
      "duration": {
        "value": 340110,
        "text": "3 jours 22 heures"
      },
      "distance": {
        "value": 1734542,
        "text": "1 735 km"
      }
    }, {
      "status": "OK",
      "duration": {
        "value": 24487,
        "text": "6 heures 48 minutes"
      },
      "distance": {
        "value": 129324,
        "text": "129 km"
      }
    } ]
  }, {
    "elements": [ {
      "status": "OK",
      "duration": {
        "value": 288834,
        "text": "3 jours 8 heures"
      },
      "distance": {
        "value": 1489604,
        "text": "1 490 km"
      }
    }, {
      "status": "OK",
      "duration": {
        "value": 14388,
        "text": "4 heures 0 minutes"
      },
      "distance": {
        "value": 135822,
        "text": "136 km"
      }
    } ]
  } ]
}

참고로, 결과에서 값을 추출하려는 경우에는 이 결과를 종합적으로 구문 분석해야 합니다. JSON 구문 분석은 비교적 쉽습니다. 권장되는 디자인 패턴을 확인하려면 JSON 구문 분석을 참조하세요.

XML
<?xml version="1.0" encoding="UTF-8"?>
<DistanceMatrixResponse>
 <status>OK</status>
 <origin_address>Vancouver, BC, Canada</origin_address>
 <origin_address>Seattle, État de Washington, États-Unis</origin_address>
 <destination_address>San Francisco, Californie, États-Unis</destination_address>
 <destination_address>Victoria, BC, Canada</destination_address>
 <row>
  <element>
   <status>OK</status>
   <duration>
    <value>340110</value>
    <text>3 jours 22 heures</text>
   </duration>
   <distance>
    <value>1734542</value>
    <text>1 735 km</text>
   </distance>
  </element>
  <element>
   <status>OK</status>
   <duration>
    <value>24487</value>
    <text>6 heures 48 minutes</text>
   </duration>
   <distance>
    <value>129324</value>
    <text>129 km</text>
   </distance>
  </element>
 </row>
 <row>
  <element>
   <status>OK</status>
   <duration>
    <value>288834</value>
    <text>3 jours 8 heures</text>
   </duration>
   <distance>
    <value>1489604</value>
    <text>1 490 km</text>
   </distance>
  </element>
  <element>
   <status>OK</status>
   <duration>
    <value>14388</value>
    <text>4 heures 0 minutes</text>
   </duration>
   <distance>
    <value>135822</value>
    <text>136 km</text>
   </distance>
  </element>
 </row>
</DistanceMatrixResponse>

어떤 이유로 서비스에 xml이 꼭 필요한 경우가 아니라면 json을 기본 출력 플래그로 사용하는 것이 좋습니다. XML 트리를 처리할 때는 올바른 노드와 요소를 참조하도록 주의해야 합니다. 출력 처리에 권장되는 디자인 패턴을 확인하려면 XPath로 XML 구문 분석을 참조하세요.

이 문서의 나머지 부분에서는 JSON 구문을 사용합니다.

거리 행렬 응답 요소

거리 행렬 응답은 다음과 같은 루트 요소를 포함합니다.

  • "status"는 요청의 메타데이터를 포함합니다. 아래의 상태 코드를 참조하세요.
  • origin_addresses는 원래 요청으로부터 API에 의해 반환되는 주소 배열을 포함합니다. 이들 주소의 형식은 지오코더에 의해 지정되며 요청과 함께 전달된 language 매개변수에 따라 현지화됩니다.
  • destination_addresses는 원래 요청으로부터 API에 의해 반환되는 주소 배열을 포함합니다. origin_addresses와 마찬가지로, 이들 주소도 현지화됩니다.
  • rowselements 배열을 포함하며, 이 배열은 각각 status, durationdistance 요소를 포함합니다.

상태 코드

응답 객체의 status 필드에는 요청의 상태가 포함되며, 유용한 디버깅 정보가 포함될 수도 있습니다. Distance Matrix API는 요청에 대한 일반적인 정보와 함께 최상위 상태 필드를 반환할 뿐만 아니라, 특정 출발지-목적지 쌍에 대한 정보와 함께 각 요소 필드의 상태 필드를 반환합니다.

최상위 상태 코드
  • OK는 응답이 올바른 result를 포함함을 나타냅니다.
  • INVALID_REQUEST는 제공된 요청이 잘못되었음을 나타냅니다.
  • MAX_ELEMENTS_EXCEEDED는 출발지와 목적지의 곱이 쿼리당 제한을 초과함을 나타냅니다.
  • OVER_QUERY_LIMIT는 허용된 시간 기간 내에 서비스가 애플리케이션에서 너무 많은 요청을 수신했음을 나타냅니다.
  • REQUEST_DENIED는 서비스가 애플리케이션의 거리 행렬 서비스 사용을 거부했음을 나타냅니다.
  • UNKNOWN_ERROR는 서버 오류로 인해 거리 행렬 요청을 처리할 수 없음을 나타냅니다. 다시 시도하면 요청이 성공할 수도 있습니다.
요소 수준의 상태 코드
  • OK는 응답이 올바른 result를 포함함을 나타냅니다.
  • NOT_FOUND는 이 쌍의 출발지 및/또는 목적지를 지오코딩할 수 없음을 나타냅니다.
  • ZERO_RESULTS는 출발지와 목적지 사이에 경로를 찾을 수 없음을 나타냅니다.

오류 메시지

최상위 상태 코드가 OK 이외인 경우, 거리 행렬 응답 객체 내에 추가적인 error_message 필드가 있을 수 있습니다. 이 필드에는 지정된 상태 코드가 제시된 이유에 대한 상세정보가 포함됩니다.

참고: 이 필드는 항상 존재하는 것은 아니며 내용이 변경될 수 있습니다.

Google Maps Distance Matrix API가 결과를 반환할 때, JSON rows 배열 내에 결과를 넣습니다. 결과를 반환하지 않는 경우에도(예: 출발지 및/또는 목적지가 존재하지 않는 경우) 여전히 빈 배열을 반환합니다. XML 응답은 0개 이상의 <row> 요소로 구성됩니다.

행의 순서는 요청의 origin 매개변수 값에 따라 지정됩니다. 각 행은 출발지에 해당하고, 이 행 내의 각 element는 이 출발지와 destination 값의 쌍에 해당합니다.

row 배열은 하나 이상의 element 항목을 포함하며, 이 항목은 각각 단일 출발지-목적지 쌍에 대한 정보를 포함합니다.

요소

각 출발지-목적지 쌍에 대한 정보가 element 항목에 반환됩니다. element는 다음 필드를 포함합니다.

  • status: 가능한 상태 코드 목록은 상태 코드를 참조하세요.
  • duration: 이 경로를 이동하는 데 걸리는 시간이며, 초 단위(value 필드)와 text로 표현됩니다. 텍스트 표현은 쿼리의 language 매개변수에 따라 현지화됩니다.
  • duration_in_traffic: 이 경로를 이동하는 데 걸리는 시간이며, 과거 및 현재의 교통 상황을 기준으로 합니다. 반환되는 값이 optimistic, pessimistic 또는 best-guess 예상 값이 되도록 요청하는 데 사용할 수 있는 옵션에 대해서는 traffic_model 요청 매개변수를 참조하세요. 소요 시간은 초 단위(value 필드)와 text로 표현됩니다. 텍스트 표현은 쿼리의 language 매개변수에 따라 현지화됩니다. 교통량을 고려한 기간은 다음 사항이 모두 참인 경우에만 반환됩니다.

    • 요청이 departure_time 매개변수를 포함합니다.
    • 요청이 올바른 API 키나 올바른 Google Maps API 프리미엄 플랜 클라이언트 ID 및 서명을 포함합니다.
    • 요청한 경로에 대해 교통 상황이 제공됩니다.
    • mode 매개변수가 driving으로 설정되었습니다.
  • distance: 이 경로의 전체 거리이며, 미터(value)와 text로 표현됩니다. 이 텍스트 값은 원래 요청의 unit 매개변수에 지정된 단위 체계를 사용하거나 출발지 지역의 단위 체계를 사용합니다.
  • fare: 있을 경우, 이 경로상의 전체 요금(즉, 전체 티켓 비용)을 포함합니다. 이 속성은 대중교통 요청 및 요금 정보를 사용할 수 있는 대중교통 공급자에 대해서만 반환됩니다. 이 정보에는 다음과 같은 항목이 포함됩니다.
    • currency: 금액이 표시되는 통화를 나타내는 ISO 4217 통화 코드.
    • value: 위에 지정된 통화의 전체 요금액.
    • text: 요청한 언어로 형식이 지정된 전체 요금액.

다음은 요금 정보를 포함하는 element의 예시입니다.

{
  "status": "OK",
  "duration": {
    "value": 340110,
    "text": "3 jours 22 heures"
  },
  "distance": {
    "value": 1734542,
    "text": "1 735 km"
  }
  "fare" : {
    "currency" : "USD",
    "value" : 6,
    "text" : "$6.00"
  },
}

sensor 매개변수

이전의 Google Maps API는 애플리케이션이 사용자의 위치 파악을 위해 센서를 사용했는지 여부를 나타내기 위해 sensor 매개변수를 포함하도록 요구했습니다. 이 매개변수는 더 이상 필요하지 않습니다.

다음에 대한 의견 보내기...

Google Maps Distance Matrix API
Google Maps Distance Matrix API
도움이 필요하시나요? 지원 페이지를 방문하세요.