경로 응답

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

이 제품은 기존 상태입니다. 2026년 10월부터는 새 Google Cloud 프로젝트에서 Directions API (기존)를 더 이상 사용 설정할 수 없습니다. 기존 프로젝트는 계속해서 완전히 지원됩니다. 새로운 기능과 향상된 성능을 이용하려면 Routes API로 이전하세요.

샘플 응답

경로 응답은 URL 요청 경로 내의 output 플래그로 표시된 형식으로 반환됩니다.

아래의 샘플 HTTP 요청은 일리노이주 시카고에서 미주리주 조플린과 오클라호마주 오클라호마시티의 경유지 두 곳을 거쳐 캘리포니아주 로스앤젤레스로 가는 경로를 계산합니다.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Los%20Angeles%2C%20CA
  &origin=Chicago%2C%20IL
  &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'

위의 예시는 JSON 출력을 요청합니다. XML 출력을 요청할 수도 있습니다. 아래 탭을 선택하여 샘플 JSON 및 XML 응답을 확인하세요.

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 41.8781139, "lng": -87.6297872 },
            "southwest": { "lat": 34.0523525, "lng": -118.2435717 },
          },
        "copyrights": "Map data ©2022 Google, INEGI",
        "legs":
          [
            {
              "distance": { "text": "579 mi", "value": 932311 },
              "duration": { "text": "8 hours 48 mins", "value": 31653 },
              "end_address": "Joplin, MO, USA",
              "end_location": { "lat": 37.0842449, "lng": -94.513284 },
              "start_address": "Chicago, IL, USA",
              "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
              "steps":
                [
                  {
                    "distance": { "text": "443 ft", "value": 135 },
                    "duration": { "text": "1 min", "value": 24 },
                    "end_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>",
                    "polyline": { "points": "eir~FdezuOdCEjBC" },
                    "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
                    "travel_mode": "DRIVING",
                  },
                  {
                    "distance": { "text": "269 ft", "value": 82 },
                    "duration": { "text": "1 min", "value": 20 },
                    "end_location": { "lat": 41.8768866, "lng": -87.63073 },
                    "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>",
                    "maneuver": "turn-right",
                    "polyline": { "points": "sar~FzdzuO@fC?|@" },
                    "start_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
            // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity
          ],
        "overview_polyline":
          {
            "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)",
          },
        "summary": "I-55 S and I-44",
        "warnings": [],
        "waypoint_order": [0, 1],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>I-55 S and I-44</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8781139</lat>
     <lng>-87.6297872</lng>
    </start_location>
    <end_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </end_location>
    <polyline>
     <points>eir~FdezuOdCEjBC</points>
    </polyline>
    <duration>
     <value>24</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Head &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>135</value>
     <text>443 ft</text>
    </distance>
   </step>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </start_location>
    <end_location>
     <lat>41.8768866</lat>
     <lng>-87.6307300</lng>
    </end_location>
    <polyline>
     <points>sar~FzdzuO@fC?|@</points>
    </polyline>
    <duration>
     <value>20</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Turn &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>82</value>
     <text>269 ft</text>
    </distance>
    <maneuver>turn-right</maneuver>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>31653</value>
    <text>8 hours 48 mins</text>
   </duration>
   <distance>
    <value>932311</value>
    <text>579 mi</text>
   </distance>
   <start_location>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </start_location>
   <end_location>
    <lat>37.0842449</lat>
    <lng>-94.5132840</lng>
   </end_location>
   <start_address>Chicago, IL, USA</start_address>
   <end_address>Joplin, MO, USA</end_address>
  </leg>
  <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity -->
  <copyrights>Map data ©2022 Google, INEGI</copyrights>
  <overview_polyline>
   <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points>
  </overview_polyline>
  <waypoint_index>0</waypoint_index>
  <waypoint_index>1</waypoint_index>
  <bounds>
   <southwest>
    <lat>34.0523525</lat>
    <lng>-118.2435717</lng>
   </southwest>
   <northeast>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

이 문서의 나머지 부분에서는 JSON 구문을 사용합니다. 대부분의 경우 출력 형식은 문서의 개념이나 필드 이름을 설명하는 데 중요하지 않습니다. 하지만 다음과 같은 미묘한 차이가 있습니다.

  • XML 결과는 루트 <DirectionsResponse> 요소로 래핑됩니다.
  • JSON은 복수 배열 (예: steps 및 legs)을 사용하여 여러 요소가 있는 항목을 나타내고 XML은 여러 단수 요소 (예: <step> 및 <leg>)를 사용하여 이를 나타냅니다.
  • JSON은 waypoint_order 필드를 통해 경유지 순서를 나타내고 XML은 개별 <waypoint_index> 요소를 사용하여 이를 나타냅니다.
  • 빈 요소는 JSON에서는 빈 배열로 표시되지만 XML에서는 이러한 요소가 없는 것으로 표시됩니다. 예를 들어 결과가 생성되지 않는 응답은 JSON에서 빈 routes 배열을 반환하지만 XML에서는 <route> 요소를 반환하지 않습니다.

DirectionsResponse

필드 필수 유형 설명
required Array<DirectionsRoute>

출발지에서 목적지까지의 경로 배열이 포함됩니다. 경로는 중첩된 구간과 단계로 구성됩니다.

자세한 내용은 DirectionsRoute를 참고하세요.
required DirectionsStatus

요청의 상태가 포함되며 요청이 실패한 이유를 추적하는 데 도움이 되는 디버깅 정보가 포함될 수도 있습니다.

자세한 내용은 DirectionsStatus를 참고하세요.
선택사항 Array<TravelMode>

사용 가능한 이동 수단의 배열을 포함합니다. 이 필드는 요청에서 이동 수단을 지정하고 결과를 가져오지 않는 경우에 반환됩니다. 배열에는 지정된 경유지 집합의 국가에서 사용할 수 있는 이동 수단이 포함됩니다. 하나 이상의 경유지가 '경유지'인 경우 이 필드는 반환되지 않습니다.

자세한 내용은 TravelMode를 참고하세요.
선택사항 문자열

서비스가 OK 이외의 상태 코드를 반환하는 경우 응답 객체 내에 추가 error_message 필드가 있을 수 있습니다. 이 필드에는 지정된 상태 코드의 이유에 관한 자세한 정보가 포함됩니다. 이 필드가 항상 반환되는 것은 아니며 콘텐츠는 변경될 수 있습니다.

선택사항 Array<DirectionsGeocodedWaypoint>

출발지, 목적지, 경유지의 지오코딩에 관한 세부정보가 포함된 배열이 포함됩니다. geocoded_waypoints 배열의 요소는 0부터 시작하는 위치에 따라 출발지, 지정된 순서의 경유지, 목적지에 해당합니다.

서비스에서 결과를 반환하지 않는 경우 텍스트 위도/경도 값으로 지정된 경유지에는 이러한 세부정보가 표시되지 않습니다. 이러한 경유지는 경로를 찾은 후에만 역 지오코딩되어 대표 주소를 가져오기 때문입니다. 빈 JSON 객체는 geocoded_waypoints 배열에서 해당 위치를 차지합니다.

자세한 내용은 DirectionsGeocodedWaypoint를 참고하세요.

DirectionsRoute

경로는 중첩된 legs 및 steps로 구성됩니다.

필드 필수 유형 설명
required 경계

overview_polyline의 표시 영역 경계 상자를 포함합니다.

자세한 내용은 경계를 참고하세요.
required 문자열

이 경로에 대해 표시해야 할 저작권 고지가 포함됩니다. 이 정보는 직접 처리하고 표시해야 합니다. 이 콘텐츠는 있는 그대로 읽어야 합니다. 이 표시 전용 콘텐츠를 프로그래매틱 방식으로 파싱하지 마세요.

required Array<DirectionsLeg>

지정된 경로 내 두 위치 사이 하나의 구간에 대한 정보가 포함된 배열입니다. 지정된 각 경유지 또는 목적지에 대해 별도의 구간이 존재합니다. (경유지가 없는 경로에는 구간 배열 내에 정확히 하나의 구간이 포함됩니다.) 각 구간은 일련의 단계로 구성됩니다.

자세한 내용은 DirectionsLeg를 참고하세요.
required DirectionsPolyline

경로의 인코딩된 다중선 표현이 포함된 객체가 포함됩니다. 이 다중선은 결과 경로의 대략적인 (평활화된) 경로입니다.

자세한 내용은 DirectionsPolyline을 참고하세요.
required 문자열

경로의 이름을 지정하고 대체 경로와 구분하는 데 적합한 경로에 대한 간단한 텍스트 설명이 포함되어 있습니다.

required Array<string>

이 경로를 보여줄 때 표시해야 할 경고의 배열이 포함됩니다. 이 경고를 직접 처리하고 표시해야 합니다.

required Array<integer>

계산된 경로에 있는 경유지의 순서를 나타내는 배열입니다. 요청이 경유지 매개변수 내에서 optimize:true를 전달한 경우 이 경유지의 순서가 변경될 수 있습니다.

선택사항 요금

있을 경우, 이 경로상의 전체 요금(즉, 전체 티켓 비용)을 포함합니다. 이 속성은 대중교통 요청 및 모든 대중교통 구간에 대해 요금 정보를 사용할 수 있는 경로의 경우에만 반환됩니다.

자세한 내용은 요금을 참고하세요.

경계

남서쪽 및 북동쪽 모서리의 지점에서 지리적 좌표로 표시된 직사각형입니다.

필드 필수 유형 설명
required LatLngLiteral 자세한 내용은 LatLngLiteral을 참고하세요.
required LatLngLiteral 자세한 내용은 LatLngLiteral을 참고하세요.

LatLngLiteral

위도와 경도를 십진수로 사용하여 특정 위치를 설명하는 객체입니다.

필드 필수 유형 설명
required 숫자

십진법 각도로 표기하는 위도
required 숫자

십진법 각도로 표기되는 경도

DirectionsLeg

필드 필수 유형 설명
required 문자열

이 구간의 end_location를 역 지오코딩한 결과로 인간이 읽을 수 있는 주소 (일반적으로 상세 주소)가 포함됩니다. 이 콘텐츠는 있는 그대로 읽어야 합니다. 형식이 지정된 주소를 프로그래매틱 방식으로 파싱하지 마세요.

required LatLngLiteral

이 구간의 지정된 목적지의 위도/경도 좌표입니다. Directions API는 출발지와 도착지에서 가장 가까운 교통수단 옵션 (일반적으로 도로)을 사용하여 위치 간의 거리를 계산하기 때문에, 예를 들어 목적지 근처에 도로가 없는 경우 end_location이 구간의 제공된 목적지와 다를 수도 있습니다.

자세한 내용은 LatLngLiteral을 참고하세요.
required 문자열

이 구간의 start_location를 역 지오코딩한 결과로 사람이 읽을 수 있는 주소 (일반적으로 상세 주소)가 포함됩니다. 이 콘텐츠는 있는 그대로 읽어야 합니다. 형식이 지정된 주소를 프로그래매틱 방식으로 파싱하지 마세요.

required LatLngLiteral

이 구간 출발지의 위도/경도 좌표입니다. Directions API는 출발지와 도착지에서 가장 가까운 교통수단 옵션(일반적으로 도로)을 사용하여 위치 간의 거리를 계산하기 때문에, 예를 들어 출발지 근처에 도로가 없는 경우 start_location이 구간의 제공된 출발지와 다를 수도 있습니다.

자세한 내용은 LatLngLiteral을 참고하세요.
required Array<DirectionsStep>

여정 구간에 있는 별도의 각 단계에 대한 정보를 표시하는 단계의 배열입니다.

자세한 내용은 DirectionsStep을 참고하세요.

traffic_speed_entry

선택사항 Array<DirectionsTrafficSpeedEntry>

구간의 교통 속도에 관한 정보입니다.

자세한 내용은 DirectionsTrafficSpeedEntry를 참고하세요.

required Array<DirectionsViaWaypoint>

이 구간의 경유지 위치입니다.

자세한 내용은 DirectionsViaWaypoint를 참고하세요.

선택사항 TimeZoneTextValueObject

이 구간의 도착 예정 시간이 포함됩니다. 이 속성은 대중교통 경로에 대해서만 반환됩니다.

자세한 내용은 TimeZoneTextValueObject를 참고하세요.

선택사항 TimeZoneTextValueObject

이 구간의 출발 예상 시간이 Time 객체로 포함됩니다. departure_time은 대중교통 경로에만 사용할 수 있습니다.

자세한 내용은 TimeZoneTextValueObject를 참고하세요.

선택사항 TextValueObject

이 구간에서 다루는 총 거리입니다.

자세한 내용은 TextValueObject를 참고하세요.
선택사항 TextValueObject

이 구간의 총 소요시간입니다.

자세한 내용은 TextValueObject를 참고하세요.
선택사항 TextValueObject

이 구간의 총 소요 시간을 나타냅니다. 이 값은 현재 및 이전 교통 상황을 기반으로 한 교통 상황에서의 예상 시간입니다. 반환된 값이 낙관적, 비관적 또는 최적 추정치인지 요청하는 데 사용할 수 있는 옵션은 traffic_model 요청 매개변수를 참고하세요. 교통 상황을 반영한 이동 시간은 다음 조건이 모두 참인 경우에만 반환됩니다.

  • 요청에 중간 기착 경유지가 포함되지 않았습니다. 요청에 경유지가 포함된 경우 중간 기착을 피하려면 경유지 앞에 via:를 붙여야 합니다.
  • 운전 경로에 관한 요청입니다. mode 매개변수가 driving으로 설정되었습니다.
  • 요청에 departure_time 매개변수가 포함되어 있습니다.
  • 요청된 경로에 대해 교통상황이 제공됩니다.

자세한 내용은 TextValueObject를 참고하세요.

DirectionsStep

steps 배열의 각 요소는 계산된 경로의 단일 단계를 정의합니다. 단계는 경로의 최소 단위이며 여정의 구체적이고 개별적인 안내를 제공하는 단일 단계가 포함됩니다. 예: 'W. 4th St.에서 좌회전' 단계에는 안내 및 이 단계가 다음 단계와 어떻게 관련되는지에 관한 거리 및 소요 시간 정보가 포함됩니다. 예를 들어 'I-80 West로 합류'라고 표시된 단계에, 다음 단계가 이 단계로부터 59.5킬로미터/40분 거리에 있음을 나타내는 '59.5킬로미터' 및 '40분'의 소요 시간이 포함될 수도 있습니다.

Directions API를 사용하여 대중교통 경로를 검색할 때는 단계 배열에 transit_details 배열 형태의 대중교통 세부정보가 추가로 포함됩니다. 경로에 여러 교통수단이 포함되어 있는 경우에는 내부 단계 배열에 자세한 도보 경로 또는 운전 경로가 제공됩니다. 예를 들어 도보 단계에는 출발지에서 목적지까지의 경로가 포함됩니다(예: 'Innes Ave & Fitch St까지 도보로 이동'). 이 단계에는 내부 단계 배열에 해당 경로의 자세한 도보 경로가 포함됩니다(예: '북서쪽으로 이동', 'Arelious Walker로 좌회전', 'Innes Ave로 좌회전').

필드 필수 유형 설명
required TextValueObject

다음 단계에 도달할 때까지 이 단계를 완료하는 데 필요한 일반적인 시간이 포함됩니다. 소요 시간을 알 수 없는 경우 이 필드가 정의되지 않을 수도 있습니다.

자세한 내용은 TextValueObject를 참고하세요.
required LatLngLiteral

이 단계의 마지막 지점 위치를 포함합니다.

자세한 내용은 LatLngLiteral을 참고하세요.
required 문자열

이 단계에 대한 형식이 지정된 안내가 HTML 텍스트 문자열로 포함됩니다. 이 콘텐츠는 있는 그대로 읽어야 합니다. 이 표시 전용 콘텐츠를 프로그래매틱 방식으로 파싱하지 마세요.

required DirectionsPolyline

단계의 인코딩된 다중선 표현이 포함된 단일 점 객체가 포함됩니다. 이 폴리라인은 스텝의 대략적인(다듬어진) 경로입니다.

자세한 내용은 DirectionsPolyline을 참고하세요.
required LatLngLiteral

이 단계의 출발지 위치를 포함합니다.

자세한 내용은 LatLngLiteral을 참고하세요.
required TravelMode

사용된 이동 수단 유형이 포함됩니다.

자세한 내용은 TravelMode를 참고하세요.
선택사항 TextValueObject

다음 단계에 도달할 때까지 이 단계에 포함된 거리를 포함합니다. 거리를 알 수 없는 경우 이 필드가 정의되지 않을 수도 있습니다.

자세한 내용은 TextValueObject를 참고하세요.
선택사항 문자열

현재 단계에서 수행할 작업 (좌회전, 합류, 직진 등)을 포함합니다. 값은 변경될 수 있으며 사전 고지 없이 새로운 값이 도입될 수도 있습니다.

The allowed values include: turn-slight-left, turn-sharp-left, turn-left, turn-slight-right, turn-sharp-right, keep-right, keep-left, uturn-left, uturn-right, turn-right, straight, ramp-left, ramp-right, merge, fork-left, fork-right, ferry, ferry-train, roundabout-left, and roundabout-right
선택사항

대중교통 경로의 도보 또는 운전 단계에 대한 자세한 안내가 포함됩니다. 하위 단계는 travel_mode가 'transit'으로 설정된 경우에만 사용할 수 있습니다. 내부 단계 배열은 단계와 동일한 유형입니다.

선택사항 DirectionsTransitDetails

이동 수단이 transit인 경우 이 단계와 관련된 세부정보입니다.

자세한 내용은 DirectionsTransitDetails를 참고하세요.

TextValueObject

숫자 값과 형식화된 텍스트 표현이 포함된 객체입니다.

필드 필수 유형 설명

text

required 문자열

문자열 값입니다.
required 숫자

숫자 값입니다.

DirectionsPolyline

다중선 인코딩은 일련의 좌표를 단일 문자열로 저장할 수 있는 손실 압축 알고리즘입니다. 지점 좌표는 서명된 값을 사용하여 인코딩됩니다. 고정된 지점이 몇 개만 있는 경우 대화형 다중선 인코딩 유틸리티를 사용할 수도 있습니다.

인코딩 프로세스는 익숙한 base64 인코딩 스키마를 사용하여 바이너리 값을 ASCII 문자의 일련의 문자 코드로 변환합니다. 이러한 문자를 올바르게 표시하기 위해 인코딩된 값은 ASCII로 변환하기 전에 63 (ASCII 문자 '?')과 합산됩니다. 또한 알고리즘은 각 바이트 그룹의 최하위 비트를 확인하여 지정된 지점의 추가 문자 코드를 확인합니다. 이 비트가 1로 설정되면 지점이 아직 완전히 형성되지 않은 것이며 추가 데이터가 뒤따라야 합니다.

또한 공간을 절약하기 위해 포인트에는 이전 포인트의 오프셋만 포함됩니다 (물론 첫 번째 포인트는 제외). 위도와 경도는 부호가 있는 값이므로 모든 지점은 부호가 있는 정수로 Base64로 인코딩됩니다. 다중선 내의 인코딩 형식은 위도와 경도를 나타내는 두 좌표를 적절한 정밀도로 나타내야 합니다. 최대 경도가 +/- 180도이고 소수점 이하 5자리 (180.00000~-180.00000)의 정밀도를 갖는 경우 32비트 부호 있는 바이너리 정수 값이 필요합니다.

필드 필수 유형 설명
required 문자열

다중선의 단일 문자열 표현입니다.

TravelMode

  • DRIVING (기본값)은 도로망을 사용한 계산을 나타냅니다.
  • BICYCLING은 자전거 전용 도로 및 선호하는 거리를 사용하는 자전거 경로 계산을 요청합니다 (해당하는 경우).
  • TRANSIT은 대중교통 경로를 사용한 계산을 요청합니다 (해당하는 경우).
  • WALKING은 보행자 전용 도로와 인도를 사용하는 도보 경로 계산을 요청합니다(해당하는 경우).

DirectionsTransitDetails

다른 교통수단과 무관한 추가 정보입니다.

필드 필수 유형 설명
선택사항 DirectionsTransitStop

도착 대중교통 정류장입니다.

자세한 내용은 DirectionsTransitStop을 참고하세요.

선택사항 TimeZoneTextValueObject 자세한 내용은 TimeZoneTextValueObject를 참고하세요.
선택사항 DirectionsTransitStop

출발 대중교통 정류장입니다.

자세한 내용은 DirectionsTransitStop을 참고하세요.

선택사항 TimeZoneTextValueObject 자세한 내용은 TimeZoneTextValueObject를 참고하세요.
선택사항 문자열

이 노선의 이동 방향을 지정하며 차량이나 출발 정류장에 표시됩니다. 이는 대부분의 경우 종착역입니다.

선택사항 정수

현재 동일한 정류장의 예상 배차 간격을 초 단위로 지정합니다. 예를 들어 headway 값이 600인 경우 버스를 놓치면 다음 버스까지 10분을 기다려야 합니다.

선택사항 DirectionsTransitLine

이 단계에서 사용되는 대중교통 노선에 대한 정보가 포함됩니다.

자세한 내용은 DirectionsTransitLine을 참고하세요.

선택사항 정수

출발 정류장에서 도착 정류장까지의 정류장 수입니다. 도착 정류장은 포함되지만, 출발 정류장은 포함되지 않습니다. 예를 들어 정류장 A에서 출발하여 정류장 B와 C를 지나 정류장 D에 도착하는 경로의 경우 num_stops는 3을 반환합니다.

선택사항 문자열

승객에게 대중교통 이동을 식별하기 위해 일정 및 표지판에 표시되는 텍스트입니다. 텍스트는 서비스 제공일 중의 경로를 고유하게 식별해야 합니다. 예를 들어 '538'은 평일 15시 10분에 캘리포니아주 새너제이에서 캘리포니아주 새크라멘토로 출발하는 암트랙 열차의 trip_short_name입니다.

DirectionsTransitStop

필드 필수 유형 설명
required LatLngLiteral

정류장 위치입니다.

자세한 내용은 LatLngLiteral을 참고하세요.
required 문자열

대중교통 정류장의 이름입니다.

TimeZoneTextValueObject

유닉스 시간, 시간대, 형식화된 텍스트 표현이 포함된 객체입니다.

필드 필수 유형 설명

text

required 문자열

시간대에서 문자열로 지정된 시간입니다.
required 문자열

시간대가 포함됩니다. 이 값은 IANA 시간대 데이터베이스에 정의된 시간대의 이름입니다(예: 'America/New_York').

required 숫자

유닉스 시간 또는 1970년 1월 1일 자정(UTC) 이후의 시간(초)으로 지정된 시간입니다.

DirectionsTransitLine

필드 필수 유형 설명
required Array<DirectionsTransitAgency>

이 대중교통 노선을 운영하는 대중교통 기관입니다.

자세한 내용은 DirectionsTransitAgency를 참고하세요.

required 문자열

이 대중교통 노선의 전체 이름입니다(예: '8 Avenue Local').
선택사항 문자열

이 노선의 표지판에 흔히 사용되는 색상입니다.
선택사항 문자열

이 노선과 연결된 아이콘의 URL이 포함됩니다.
선택사항 문자열

이 대중교통 노선의 짧은 이름입니다. 일반적으로 'M7' 또는 '355'와 같은 노선 번호입니다.

text_color

선택사항 문자열

이 노선의 표지판에 흔히 사용되는 색상입니다.
선택사항 문자열

대중교통 기관에서 제공하는 대중교통 노선의 URL이 포함됩니다.
선택사항 DirectionsTransitVehicle

이 대중교통 노선에서 운행되는 운송 수단의 유형입니다.

자세한 내용은 DirectionsTransitVehicle을 참고하세요.

DirectionsTransitAgency

필드 필수 유형 설명
선택사항 문자열

이 대중교통 기관의 이름입니다.
선택사항 문자열

대중교통 기관의 전화번호입니다.
선택사항 문자열

대중교통 기관의 URL입니다.

DirectionsTransitVehicle

필드 필수 유형 설명
required 문자열

이 차량의 이름입니다(대문자로 표기).
required 문자열

사용된 차량 유형입니다.

  • BUS: 버스.
  • CABLE_CAR - 일반적으로 지상에서 케이블로 운영되는 차량입니다. 공중 케이블카는 GONDOLA_LIFT 유형일 수도 있습니다.
  • COMMUTER_TRAIN: 통근 열차.
  • FERRY: 페리.
  • FUNICULAR - 케이블로 당겨서 가파른 경사를 오르는 차량입니다. 푸니쿨라는 보통 두 대의 차량으로 구성되며 각 차량이 다른 차량의 평형추 역할을 합니다.
  • GONDOLA_LIFT: 공중 케이블카
  • HEAVY_RAIL: 중전철.
  • HIGH_SPEED_TRAIN - 고속 열차.
  • INTERCITY_BUS: 시외버스.
  • LONG_DISTANCE_TRAIN - 장거리 열차입니다.
  • METRO_RAIL: 경전철
  • MONORAIL: 모노레일.
  • OTHER - 기타 모든 운송 수단은 이 유형을 반환합니다.
  • RAIL: 철도.
  • SHARE_TAXI - 합승 택시는 버스의 일종으로 경로상의 어느 곳에서나 승객이 승하차할 수 있습니다.
  • SUBWAY: 지하 경전철.
  • TRAM - 지상 경전철
  • TROLLEYBUS: 트롤리버스.
The allowed values include: BUS, CABLE_CAR, COMMUTER_TRAIN, FERRY, FUNICULAR, GONDOLA_LIFT, HEAVY_RAIL, HIGH_SPEED_TRAIN, INTERCITY_BUS, LONG_DISTANCE_TRAIN, METRO_RAIL, MONORAIL, OTHER, RAIL, SHARE_TAXI, SUBWAY, TRAM, and TROLLEYBUS
선택사항 문자열

이 운송 수단 유형과 연결된 아이콘의 URL이 포함됩니다.
선택사항 문자열

지역 교통 표지판을 기반으로 이 운송 수단 유형과 연결되는 아이콘의 URL이 포함됩니다.

DirectionsTrafficSpeedEntry

필드 필수 유형 설명
required 숫자

이 속도 카테고리가 유효한 경로를 따른 오프셋 (미터)입니다.
required 문자열

경로의 이 부분에 대한 현재 교통/속도 조건입니다.

DirectionsViaWaypoint

필드 필수 유형 설명
선택사항 LatLngLiteral

경유지의 위치입니다.

자세한 내용은 LatLngLiteral을 참고하세요.
선택사항 정수

경유지가 포함된 단계의 색인입니다.
선택사항 숫자

단계의 다중선을 따라 있는 경유지의 위치로, 0에서 1 사이의 비율로 표현됩니다.

요금

경로의 총요금입니다.

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}
필드 필수 유형 설명
required 문자열

금액이 표시되는 통화를 나타내는 ISO 4217 통화 코드

text

required 문자열

요청한 언어로 형식이 지정된 전체 요금액.
required 숫자

총 요금액(지정된 통화로 표시됨)

DirectionsStatus

Directions 응답 객체 내의 상태 필드에는 요청의 상태가 포함되며, Directions 서비스가 실패한 이유를 추적하는 데 도움이 되는 디버깅 정보가 포함될 수도 있습니다. 상태 필드에는 다음 값이 포함될 수 있습니다.

  • OK는 응답에 유효한 결과가 포함되어 있음을 나타냅니다.
  • NOT_FOUND는 요청의 출발지, 목적지 또는 경유지에 지정된 위치 중 하나 이상을 지오코딩할 수 없음을 나타냅니다.
  • ZERO_RESULTS는 출발지와 목적지 사이의 경로를 찾지 못했음을 나타냅니다.
  • MAX_WAYPOINTS_EXCEEDED는 요청에 너무 많은 경유지가 제공되었음을 나타냅니다. Directions API를 웹 서비스로 사용하거나 Maps JavaScript API에서 경로 서비스를 사용하는 애플리케이션의 경우 허용되는 최대 경유지 수는 25개이며 여기에 출발지와 목적지가 추가됩니다.
  • MAX_ROUTE_LENGTH_EXCEEDED는 요청된 경로가 너무 길어서 처리할 수 없음을 나타냅니다. 이 오류는 더 복잡한 경로가 반환될 때 발생합니다. 경유지, 방향 전환 또는 안내의 수를 줄여 보세요.
  • INVALID_REQUEST는 제공된 요청이 잘못되었음을 나타냅니다. 이 상태의 일반적인 원인으로는 잘못된 매개변수 또는 파라미터 값이 있습니다.
  • OVER_DAILY_LIMIT는 다음 중 하나를 나타냅니다.
    • API 키가 누락되었거나 잘못되었습니다.
    • 계정에 결제가 사용 설정되지 않았습니다.
    • 자체 적용되는 사용량 한도를 초과했습니다.
    • 제공된 결제 수단이 더 이상 유효하지 않습니다 (예: 신용카드가 만료됨).
    지도 FAQ에서 해결 방법을 알아보세요.
  • OVER_QUERY_LIMIT은 서비스가 허용된 기간 내에 애플리케이션에서 너무 많은 요청을 수신했음을 나타냅니다.
  • REQUEST_DENIED는 서비스에서 애플리케이션의 경로 서비스 사용을 거부했음을 나타냅니다.
  • UNKNOWN_ERROR는 서버 오류로 인해 경로 요청을 처리하지 못했음을 나타냅니다. 다시 시도하면 요청이 성공할 수도 있습니다.

DirectionsGeocodedWaypoint

필드 필수 유형 설명
선택사항 문자열

지오코딩 작업 결과 발생한 상태 코드를 나타냅니다. 이 필드에는 다음과 같은 값이 포함될 수도 있습니다.

The allowed values include: OK, and ZERO_RESULTS
선택사항

지오코더가 원래 요청에 대해 정확히 일치하는 결과를 반환하지 않았지만 요청된 주소의 일부분과 일치함을 나타냅니다. 원래 요청에 맞춤법 오류 또는 불완전한 주소가 포함되어 있는지 검사할 수도 있습니다.

부분 일치는 요청에 전달되는 지역 내에 상세 주소가 존재하지 않는 경우 가장 자주 발생합니다. 요청이 동일한 지역에 있는 두 개 이상의 위치와 일치하는 경우에도 부분 일치가 반환될 수 있습니다. 예를 들어 '21 Henr St, Bristol, UK'는 Henry Street 및 Henrietta Street 모두에 대해 부분 일치를 반환합니다. 요청에 맞춤법이 틀린 주소 구성요소가 포함된 경우에는 지오코딩 서비스에서 대체 주소를 제안할 수도 있습니다. 이러한 방식으로 실행된 제안도 부분 일치로 표시될 수 있습니다.

선택사항 문자열

다른 Google API와 함께 사용할 수 있는 고유 식별자입니다. 장소 ID 개요를 참고하세요.

선택사항 Array<string>

경로를 계산하는 데 사용되는 지오코딩 결과의 주소 유형을 나타냅니다.

  • administrative_area_level_1은 국가 수준 아래 첫 번째 행정 독립체를 나타냅니다. 미국 내에서, 이러한 행정 레벨은 주입니다. 모든 국가에 이러한 행정 구역 수준이 표시되지는 않습니다. 대부분의 경우 administrative_area_level_1 짧은 이름은 ISO 3166-2 하위 구역이나 기타 널리 보급된 목록들과 거의 일치하지만 지오코딩 결과는 다양한 신호와 위치 데이터를 기반으로 하기 때문에 이러한 일치가 보장되지는 않습니다.
  • administrative_area_level_2는 국가 수준 아래 두 번째 행정 독립체를 나타냅니다. 미국 내에서, 이러한 행정 레벨은 카운티입니다. 모든 국가에 이러한 행정 구역 수준이 표시되지는 않습니다.
  • administrative_area_level_3은 국가 수준 아래 세 번째 행정 독립체를 나타냅니다. 이 유형은 하위 행정 구역을 나타냅니다. 모든 국가에 이러한 행정 구역 수준이 표시되지는 않습니다.
  • administrative_area_level_4는 국가 수준 아래 네 번째 행정 독립체를 나타냅니다. 이 유형은 하위 행정 구역을 나타냅니다. 모든 국가에 이러한 행정 구역 수준이 표시되지는 않습니다.
  • administrative_area_level_5는 국가 수준 아래 다섯 번째 행정 독립체를 나타냅니다. 이 유형은 하위 행정 구역을 나타냅니다. 모든 국가에 이러한 행정 구역 수준이 표시되지는 않습니다.
  • airport는 공항을 나타냅니다.
  • colloquial_area는 일반적으로 사용되는 독립체의 대체 이름을 나타냅니다.
  • country는 전국적인 정치적 독립체를 나타내고 일반적으로 지오코더에서 반환하는 순위가 가장 높은 유형입니다.
  • intersection은 일반적으로 두 주요 도로의 주요 교차로를 나타냅니다.
  • locality는 도시 또는 마을로 통합된 정치적 독립체를 나타냅니다.
  • natural_feature는 유명한 자연 지형지물을 나타냅니다.
  • neighborhood는 이름이 지정된 동네를 나타냅니다.
  • park는 이름이 지정된 공원을 나타냅니다.
  • plus_code는 위도와 경도에서 파생된 인코딩된 위치 참조를 나타냅니다. Plus Code는 상세 주소가 없는 (건물에 번호가 지정되지 않거나 거리 이름이 없는) 장소의 상세 주소 대신 사용할 수 있습니다. 자세한 내용은 https://plus.codes를 참고하세요.
  • point_of_interest는 이름이 지정된 관심 장소를 나타냅니다. 일반적으로 이러한 '관심 장소'는 '엠파이어 스테이트 빌딩' 또는 '에펠탑'과 같이 다른 카테고리에 쉽게 포함되지 않는 유명한 지역 항목입니다.
  • political은 정치적 독립체를 나타냅니다. 일반적으로 이 유형은 특정 행정 구역의 다각형을 나타냅니다.
  • postal_code는 국가 내에서 우편물을 보낼 때 사용되는 우편번호를 나타냅니다.
  • premise는 이름이 지정된 위치, 일반적으로 공통된 이름을 가진 건물 또는 여러 건물을 나타냅니다.
  • route는 이름이 지정된 경로(예: 'US 101')를 나타냅니다.
  • street_address는 정확한 상세 주소를 나타냅니다.
  • sublocality는 지역 아래 첫 번째 행정 독립체를 나타냅니다. 일부 위치의 경우 추가 유형 중 하나(sublocality_level_1~sublocality_level_5)를 받을 수도 있습니다. 각 하위 지역 수준은 하나의 행정 독립체입니다. 숫자가 클수록 더 작은 지리적 영역을 나타냅니다.
  • subpremise는 이름이 지정된 위치 아래 첫 번째 항목, 일반적으로 공통된 이름을 가진 여러 건물 중 한 건물을 나타냅니다.
  • tourist_attraction는 관광명소를 나타냅니다.
  • train_station는 기차역을 나타냅니다.
  • transit_station는 대중교통 정류장을 나타냅니다.

빈 유형 목록은 예를 들어 프랑스의 리외디와 같이 특정한 주소 요소에 대해 알려진 유형이 없다는 것을 나타냅니다.