소개

의 거리는 매트릭스 API 가 제공하는 서비스의 이동 거리와 시간에 대해 매트릭스의 추천해드리고 싶네요.^^ API 를 반환한 정보에 기반한 추천 사이의 경로를 시작점과 끝점에서 계산한 구글지도 API 를 구성 포함하는 행durationdistancevalues for each pair.참고:이 서비스는 자세한 경로 정보를 반환하지 않습니다. 경로 정보는 원하는 단일 출발지와 목적지를 길 찾기 API 에 전달하여 얻을 수 있습니다.

을 시작하기 전에

이 문서는 개발자가를 계산하는 여행 거리와 시간 간의 수의 점에서도 중 하나에 의해 제공 Google Maps Api. 사용 가능한 매개 변수에 대한 API 및 참조 자료 사용에 대한 소개를 제공합니다.

개발을 시작하기 전에 거리와 매트릭스 API,검토하고 인증 요구사항(을 API 키가 필요)그리고 API 를 사용 및 결제 정보(당신이 사용하도록 설정해야에 대한 청구)를 이용하실 수 있습니다

리 매트릭스를 요청

리 매트릭스 API 요청은 다음과 같은 형식으로 제공합니다.

여기서outputFormat할 수 있는 다음 값:

• json(권장) 음을 나타냅 출력에서 JavaScript 를 개체 표기법(JSON);or
• xml음을 나타냅으로 출력 XML.

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

HTTPS 또는 HTTP

보안이 중요하고 HTTPS 것이 좋습니다 가능한,특히 위한 응용 프로그램을 포함하는 민감한 사용자 데이터와 같은 사용자의 위치에 요청합니다. HTTPS 암호화를 사용하면 응용 프로그램이 더욱 안전하고 스누핑 또는 변조에 대한 저항력이 높아집니다.

HTTPS 가 불가능한 경우 HTTP 를 통해 거리 행렬 API 에 액세스하려면 다음을 사용하십시오:

요청 매개 변수를

는 특정 매개변수가 필요한 다른 사람들은 선택적입니다. Url 의 표준처럼 모든 매개 변수는 앰퍼샌드(&)문자를 사용하여 구분됩니다. 모든 예약 문자(예:더하기 기호”+”)는 URL 로 인코딩되어야 합니다.매개 변수 목록과 가능한 값은 아래에 열거되어 있습니다.

필수 매개 변수

• origins|)의 형태로,곳 ID,주소,또는 위도/경도 좌표:
  • 경우 공급 장소 ID 해야 합니다 앞으로는place_id:. 요청에 API 키 또는 Google Maps Platform Premium Plan 클라이언트 ID 가 포함된 경우에만 장소 ID 를 지정할 수 있습니다. 지오 코딩 API 및 장소 API(장소 자동 완성 포함)에서 장소 Id 를 검색할 수 있습니다. 장소 자동 완성에서 장소 Id 를 사용하는 예는 장소 자동 완성 및 길 찾기를 참조하십시오. 장소 Id 에 대한 자세한 내용은 장소 ID 개요를 참조하십시오.
  • 주소를 전달하면 서비스는 문자열을 지오 코딩하고 위도/경도 좌표로 변환하여 거리를 계산합니다. 이 좌표는 지오 코딩 API 에 의해 반환되는 좌표와 다를 수 있습니다(예:중심이 아닌 건물 입구).

    origins=Bobcaygeon+ON|24+Sussex+Drive+Ottawa+ON

    참고:를 사용하여 장소 Id 선호를 사용하여 주소 또는 위도/경도 좌표입니다. 를 사용하 좌표는 항상 결과에서는 점을 찍은 도로에 가장 가까운 사람들 좌표-수 있는지에 대한 액세스 지점을 제공,또는 도로는 것이 신속하거나 안전하게 리드를 대상입니다.
  • 위도/경도 좌표를 통과하면 가장 가까운 도로로 스냅됩니다. 장소 ID 를 전달하는 것이 바람직합니다. 좌표를 전달하는 경우 위도와 경도 값 사이에 공간이 없는지 확인하십시오.

    origins=41.43206,-81.38992|-33.86748,151.20699

    origins=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE

  • 플러스 코드 포맷되어 있어야 합 글로벌드 또는 화합물 코드입니다. 형식으로 플러스 코드와 같이 여기에(플러스 표지판을 url-탈출을%2B와 공간은 url-탈출을%20):
    • 글로벌 코드는 4 문자 영역 코드고 6 개 문자 또는 더 이상 지역 코드(849VCWC8+R9 는849VCWC8%2BR9).
    • 복합 코드는 명시 적 위치(CWC8+R9Mountain View,CA,USA isCWC8%2BR9%20Mountain%20View%20CA%20USA)가있는 6 자 이상의 로컬 코드입니다.
  • 또는,당신을 공급할 수 있는 인코딩 설정한 좌표의 사용은 인코딩된 폴리라인 알고리즘이 있습니다. 인코딩 된 폴리 라인을 사용할 때 URL 이 상당히 짧기 때문에 많은 수의 원점이있는 경우 특히 유용합니다.
    • 인코딩된 폴리선에는enc::origins=enc:gfo}EtohhU:
    • 포함할 수도 있습니다 여러 인코딩된 폴리로 구분하여 파이프 문자(|origins=enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:|enc:udymA{~bxM:
• destinationsdestinationsorigins매개 변수는,위의 설명되어 있습니다.
• key—응용 프로그램의 API 키입니다. 이 키는 할당량 관리를 위해 애플리케이션을 식별합니다. 열쇠를 얻는 방법을 배우십시오.

  참고: Google Maps Platform Premium Plan 고객은 Distance Matrix 요청에 API 키 또는 유효한 클라이언트 ID 및 디지털 서명을 사용할 수 있습니다. 프리미엄 플랜 고객을위한 인증 매개 변수에 대한 자세한 정보를 얻으십시오.

다음 예제를 사용하여 위도/경도 좌표를 지정 대상 좌표:.

다음 예제를 사용하여 플러스 코드를 지정 대상 좌표:.

다음 예는 같은 요청을 사용하여 인코딩된 폴리선:

선택 매개 변수를

• modedriving)—지정하는 수송의 형태를 사용하여 계산할 때는 거리입니다. 유효한 값 및 기타 요청 세부 정보는 이 문서의 여행 모드 섹션에 지정되어 있습니다.
• language—결과를 반환 할 언어.
  • 지원되는 언어 목록을 참조하십시오. Google 은 종종 지원되는 언어를 업데이트하므로이 목록은 철저하지 않을 수 있습니다.
  • 경우language이 제공되지 않 API 를 사용하려고 시도하는 언어로 지정한Accept-Language헤더 또는 기본 언어 도메인의 요청이 전송됩니다.
  • API 는 사용자와 지역 주민 모두에게 읽을 수있는 거리 주소를 제공하기 위해 최선을 다합니다. 그 목표를 달성하기 위해,그것은 반환한 거리 주소는 현지 언어로 음역하는 스크립트를 읽을 수 있는 사용자에 의해 필요한 경우,관찰 선호하는 언어입니다. 다른 모든 주소는 기본 설정 언어로 반환됩니다. 주소 구성 요소는 모두 첫 번째 구성 요소에서 선택되는 동일한 언어로 반환됩니다.
  • 선호하는 언어로 이름을 사용할 수없는 경우 API 가 가장 가까운 일치를 사용합니다.
  • 기본 설정 언어는 API 가 반환하기로 선택한 결과 집합과 반환되는 순서에 작은 영향을 미칩니다. 지오코더를 사용하여 해석하는 약어에 따라 다른 언어와 같은 약어를 위해 스트리트 유형,또는 동의어할 수 있는 유효한 하나의 언어나지 않습니다. 예를 들어,utca 와 tér 은 헝가리 거리의 동의어입니다.
• region—의 지역 코드로 지정한 ccTLD(국가 코드 최상위 도메인)에 있는 두 개의 문자로 구성된 값입니다. 대부분의 ccTLD 코드는 ISO3166-1 코드와 동일하며 몇 가지 예외가 있습니다. 이 매개 변수는 지오 코더의 결과에만 영향을 미치고 완전히 제한하지는 않습니다. 더 관련성이 높은 결과가 지정된 지역 외부에 존재하는 경우 포함될 수 있습니다.
• avoid—경로에 제한을 도입합니다. 유효한 값은이 문서의 제한 섹션에 지정되어 있습니다. 한 가지 제한만 지정할 수 있습니다.
• units—거리를 텍스트로 표현할 때 사용할 단위 시스템을 지정합니다. 자세한 내용은 이 문서의 단위 시스템 섹션을 참조하십시오.
• arrival_time—1970 년 1 월 1 일 UTC 자정 이후 환승 요청에 대해 원하는 도착 시간을 초 단위로 지정합니다. departure_timearrival_timearrival_time는 정수로 지정해야 합니다.
• departure_time—원하는 출발 시간. 1970 년 1 월 1 일 UTC 자정 이후 시간을 초 단위로 정수로 지정할 수 있습니다. 는 경우에는departure_time나중에 보다 9999-12-31T23:59:59.999999999Z 이 지정된 API 를 가을 다시departure_time을 9999-12-31T23:59:59.999999999Z. 또는 값을 지정할 수 있습의now설정하는 출발 시간은 현재 시간(정확한 가장 가까운 두 번째). 출발 시간은 두 가지 경우에 지정할 수 있습니다:
  • 여행 모드가 전송되는 요청: 지정할 수도 있습니다 하나의departure_timearrival_timedeparture_time기본값은 now(즉,출발 시간은 현재 시간으로 기본값)입니다.
  • 에 대한 요구가 여행지 모드 운전:지정할 수 있습니다departure_timeduration_in_traffic)는 트래픽을 조건으로 계정이다. 이 옵션은 요청에 유효한 API 키 또는 유효한 Google Maps Platform Premium Plan 클라이언트 ID 및 서명이 포함된 경우에만 사용할 수 있습니다. departure_time는 현재 시간 또는 미래의 시간으로 설정되어야 합니다. 그것은 과거에있을 수 없습니다.

    참고:출발 시간을 지정하지 않은 선택의 경로와 시간을 기반으로 도로 네트워크와 평균 시간은-독립니다. 결과에 대한 요청에 따라 다를 수 있습을 통해 시간 변경으로 인해 도로 네트워크에서,업데이트 평균 교통 상황과 분산의 자연 서비스입니다. 결과는 또한 언제든지 또는 빈도에서 거의 동등한 경로간에 다를 수 있습니다.

    참고:리 매트릭스의 요청을 지정하는departure_timemode=driving제한되는 최대 100 개의 요소별 요청을 합니다. 기원 횟수 대상 수는 요소 수를 정의합니다.

• traffic_modelbest_guessduration_in_traffictraffic_modeldrivingdeparture_time경우에만 요청을 포함한 API 키나 Google 지도 플랫폼 프리미엄 계획 클라이언트의 ID 입니다. 이 매개 변수에 사용 가능한 값은 다음과 같습니다:
  • best_guessduration_in_trafficdeparture_time가 현재에 가까울수록 더 중요 해집니다.
  • pessimisticduration_in_traffic해야 더 이상 실제 여행 시간에서 대부분의 일만,가끔 일으로 특히 나쁜 트래픽 조건을 초과할 수 있습 이 값입니다.
  • optimisticduration_in_traffic해야 보다 짧은 실제 여행 시간에서 대부분의 일만,가끔 일으로 특히 좋은 교통 상황 것보다 더 빠를 수 있습니다 이 값이 있습니다.
• transit_modemodetransit인 요청에 대해서만 지정할 수 있습니다. 매개 변수는 다음 인수를 지원합니다:
  • bus는 계산 된 경로가 버스로 여행하는 것을 선호해야 함을 나타냅니다.
  • subway는 계산 된 경로가 지하철로 여행하는 것을 선호해야 함을 나타냅니다.
  • train는 계산 된 경로가 기차로 여행하는 것을 선호해야 함을 나타냅니다.
  • tram는 계산 된 경로가 트램 및 경전철로 여행을 선호해야 함을 나타냅니다.
  • railtransit_mode=train|tram|subway와 같습니다.
• transit_routing_preference—전송 요청에 대한 기본 설정을 지정합니다. 이 매개 변수를 사용하면 API 에서 선택한 기본 최상의 경로를 수락하는 대신 반환 된 옵션을 바이어스 할 수 있습니다. 이 매개 변수는modetransit인 요청에 대해서만 지정할 수 있습니다. 매개 변수 지원 인수는 다음과 같습니다.
  • less_walking나의 계산된 경로를 선호한 제한된 양의 걷고 있다.
  • fewer_transfers는 계산 된 경로가 제한된 수의 전송을 선호해야 함을 나타냅니다.

여행 모드

에 대한 계산의 거리를 지정할 수 있습니다 교통편mode사용합니다. 기본적으로 거리는 주행 모드에 대해 계산됩니다. 다음과 같은 여행 모드 지원

• driving(기본값)거리를 나타냅 사용하여 계산합니다.
• walking&인도(여기서 사용할 수 있습니다).
• bicycling&선호하는 거리로(유효한 곳에).
• transit요청의 거리 계산을 통해 대중 교통 경로(유효한 곳에). 이 값은 요청에 API 키 또는 Google Maps Platform Premium Plan 클라이언트 ID 가 포함된 경우에만 지정할 수 있습니다. 는 경우 모드를 설정하는transitdeparture_timearrival_timedeparture_time기본값은 now(즉,출발 시간은 현재 시간으로 기본값)입니다. 또한 선택적으로transit_modetransit_routing_preference를 포함할 수 있습니다.

트래픽 정보

트래픽 정보를 사용하면 다음과 같은 모든 적용(이러한 데 필요한 조건을 받duration_in_traffic분야에서 거리 응답 행렬):

• 여행modedrivingdriving은 기본 여행지 모드).
• 요청에는 유효한departure_timedeparture_time는 현재 시간 또는 미래의 일부 시간으로 설정할 수 있습니다. 그것은 과거에있을 수 없습니다.

선택적으로 포함할 수 있습니다traffic_model매개 변수는 귀하의 요청에 지정한 가정이 사용하면 시간을 계산하는 교통.

다음 URL 은 Boston,MA 또는 Charlestown,MA 및 Lexington,MA 및 Concord,MA 사이의 주행 거리에 대한 거리 매트릭스 요청을 시작합니다. 요청을 포함한 출발시간,회의 모든 요구 사항을 반환하는duration_in_traffic필드 거리에서 매트릭스 반응이다.

제한

거리는 특정 제한을 준수 계산 될 수있다. 제한은avoid매개 변수의 사용으로 표시되며 피할 제한을 나타내는 해당 매개 변수에 대한 인수입니다. 다음과 같은 제한을 지원

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

*주의: 한의 제한을 방해 하지 않는 노선이 포함된 제한된 기능이다;그것은 편견은 결과를 더 유리한다.

단위 시스템

리 매트릭스의 결과를 포함textdistance필드를 나타내의 거리를 계산됩니다. 단위 시스템을 사용하여 지정 될 수 있습니다:

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

*참고:이 장치는 시스템을 설정만 영향을 미치는textdistancedistancevalues도 포함됩니다.

리 매트릭스 반응

응답 거리 Matrix API 쿼리에서 반환된 형식으로 표시된output국내에서 URL 을 요청의 경로입니다.

두 개의 샘플 HTTP 요청은 아래와 같이 요청하는 거리와 시간에서 밴쿠버,BC,캐나다 및에서 시애틀,WA,미국,샌프란시스코,미국 캘리포니아 및 빅토리아,BC,Canada.

이 요청은 JSONoutput플래그를 사용하여 보여줍니다:

이 요청을 사용하는 방법을 보여 줍니다 XMLoutput플래그:

이 요청을 반환됩니다 네 가지 요소에-두 개의 기원은 번 두 가지 목적:

결과를 반환에서 행 각 행은 포함하는 하나의 원산지와 결합니다.

웹 브라우저에 URL 을 입력하여 테스트 할 수 있습니다(YOUR_API_KEY를 실제 API 키로 대체하십시오).

샘플 JSON 및 XML 응답을 보려면 아래 탭을 선택하십시오.

이 설명서의 나머지 부분은 JSON 구문을 사용합니다.

리 행렬 응답 요소

리 매트릭스 반응은 다음을 포함본 요소:

• status포함되어에 대한 메타데이터 요청을 합니다. 아래 상태 코드를 참조하십시오.
• origin_addresses는 원래 요청에서 API 에 의해 반환 된 주소 배열을 포함합니다. 이들은 지오 코더에 의해 포맷되고 요청과 함께 전달 된language매개 변수에 따라 지역화됩니다.
• destination_addresses는 원래 요청에서 API 에 의해 반환 된 주소 배열을 포함합니다. origin_addresses와 마찬가지로 적절한 경우 현지화됩니다.
• rowselementsstatusduration,anddistance요소입니다.

상태 코드

status분야에 응답 개체 포함된 요청의 상태를 포함할 수 있습 유용한 디버깅 정보입니다. 의 거리는 매트릭스 API 가 반환하는 최고 수준의 상태 필드의 정보와 함께 요청에 대해 일반적으로,뿐만 아니라 상태 필드의 각 요소에 대한 분야에 대한 정보와 함께,그 특정 원산지 목적지합니다.

최고 수준의 상태 코드

• OKresult.
• INVALID_REQUEST는 제공된 요청이 유효하지 않음을 나타냅니다.
• MAX_ELEMENTS_EXCEEDED는 원본 및 대상의 곱이 쿼리 당 제한을 초과 함을 나타냅니다.
• MAX_DIMENSIONS_EXCEEDED는 원본 또는 대상 수가 쿼리 당 제한을 초과 함을 나타냅니다.
• OVER_DAILY_LIMIT는 다음 중 하나를 나타냅니다.
  • API 키가 없거나 잘못되었습니다.계정에서
  • 결제를 사용할 수 없습니다.
  • 자체 부과 된 사용 캡이 초과되었습니다.
  • 제공된 지불 방법이 더 이상 유효하지 않습니다(예:신용 카드가 만료되었습니다).

  이 문제를 해결하는 방법을 배우려면지도 FAQ 를 참조하십시오.

• OVER_QUERY_LIMIT을 나타내 서비스가 받은 너무 많은 요청 응용 프로그램에서 허용되는 시간 내에 기간이다.
• REQUEST_DENIED는 것을 나타냅 서비스를 거부하 사용하는 거리의 행렬에 의해 서비스 응용 프로그램입니다.
• UNKNOWN_ERROR는 서버 오류로 인해 거리 매트릭스 요청을 처리 할 수 없음을 나타냅니다. 다시 시도하면 요청이 성공할 수 있습니다.

요소는 수준의 상태 코드

• OKresult.
• NOT_FOUND는 이 페어링의 원점 및/또는 대상을 지오코딩할 수 없음을 나타냅니다.
• ZERO_RESULTS는 출발지와 목적지 사이에 경로를 찾을 수 없음을 나타냅니다.
• MAX_ROUTE_LENGTH_EXCEEDED는 요청한 경로가 너무 길어 처리 할 수 없음을 나타냅니다.

오류 메시지

면 최고 수준의 상태코드가 아닌 다른OKerror_message분야 내에서 거리 응답 행렬 개체입니다. 이 필드에는주어진 상태 코드 뒤에있는 이유에 대한 자세한 정보.

참고:이 필드는 항상 존재한다고 보장되는 것은 아니며 변경 될 수 있습니다.

행

거리 행렬 API 가 결과를 반환하면 JSONrows배열 내에 배치합니다. 결과가 반환되지 않더라도(예:기원 및/또는 목적지가 존재하지 않는 경우)여전히 빈 배열을 반환합니다. XML 응답은 0 개 이상의<row>요소로 구성됩니다.

행은 요청의originelementdestination값입니다.

각rowelement항목에 차례에 대한 정보가 포함되어 있는 단일 원점-대상 페어링입니다.

요소

각 출발지-목적지 페어링에 대한 정보는elementelement는 다음 필드가 포함되어 있습니다.

• status:조 상태코드 목록에 대한 가능한 상태 코드입니다.
• durationvaluetextlanguage매개 변수에 따라 지역화됩니다.

• duration_in_traffictraffic_modelvaluetextlanguage매개 변수에 따라 지역화됩니다. 기간 트래픽에서 반환하는 경우에만 다음과 같은 모든다.

  • 요청에 포함departure_time매개 변수입니다.
  • 요청에는 유효한 API 키 또는 유효한 Google 지도 플랫폼 프리미엄 플랜 클라이언트 ID 및 서명이 포함됩니다.
  • 요청한 경로에 대해 교통 상황을 사용할 수 있습니다.
  • modedriving로 설정됩니다.
• distancevaluetextunit매개 변수의 원래 요청,또는 원산지의 지역입니다.
• fare:있는 경우 이 노선의 총 요금(즉,총 티켓 비용)을 포함합니다. 이 숙박 시설은 환승 요청에 대해서만 반환되며 요금 정보를 이용할 수 있는 환승 업체에 대해서만 반환됩니다. 한 정보를 포함됩니다:
  • currency:ISO4217 통화 코드를 나타내는 통화는 금액에서 표현.
  • value:위에서 지정한 통화로 총 운임 금액입니다.
  • text:요청한 언어로 서식이 지정된 총 운임 금액입니다.

아래의 예는element포함하는 요금 정보를 제공합니다:

센서 매개 변수

Google 지도 API 를 이전에 필요 포함하는sensor매개 변수를 나타내는지 여부를하는 데 사용되는 응용 프로그램 asensor 을 결정하는 사용자의 위치에 있습니다. 이 매개 변수는 더 이상 필요하지 않습니다.필요합니다.