대중교통 경로 확인

대중교통 경로는 대중교통을 사용한 내비게이션 안내를 제공합니다. 리전에서 사용할 수 있는 옵션을 제공합니다 대중교통 옵션에는 버스, 지하철, 기차 등이 포함될 수 있습니다. 대중교통 경로에는 일반적으로 대중교통 정거장까지, 정거장 사이, 정거장에서의 도보 경로에 관한 안내도 포함됩니다. 대중교통 경로 일반적으로 두 가지 이상의 이동 수단을 이용해야 하며, 경로를 요청하고 응답의 일부가 다릅니다.

대중교통 경로와 다른 경로의 차이점

transit의 travelMode를 설정하여 요청하는 대중교통 경로는 다른 travelMode 옵션을 사용하는 경로에서 동일한 객체와 옵션을 모두 요청할 수 없으며 다른 경로와 비교했을 때,

Routes API에서 단계는 일관된 하나의 탐색 안내입니다. 모든 유형의 여행에 걸쳐 있습니다 각 탐색 명령은 하나의 단계입니다. 대중교통 경로 응답은 다른 이동 수단을 사용하는 경로와 매우 유사하지만 차이점:

요청 차이 응답 차이
중간 경유지는 지정할 수 없습니다. 대중교통 세부정보가 포함됩니다.
친환경 경로를 가져올 수 없음 각 이동 수단에 대한 메타데이터를 포함하여 각 이동 수단의 단계 요약을 포함합니다. `stepsOverview`의 모든 이동수단을 확인할 수 있습니다 (이 메타데이터를 요청하려면 `routes.legs.stepsOverview` 필드 마스크).
트래픽 데이터를 포함할지 여부와 방법을 지정할 수 없음
피할 경로 지형지물을 지정할 수 없음
transitPreferences만 지정할 수 있습니다. routingPreference입니다. 자세한 내용은 [TransitPreferences](reference/rest/v2/TransitPreferences).

Routes API에서 반환하는 응답에 대한 자세한 내용은 다음을 참조하세요. 대중교통 경로 응답을 검토합니다.

대중교통 경로 확인

  1. 출발지와 목적지를 설정합니다.

  2. 이동 수단을 대중교통으로 설정합니다.

    travelMode: "TRANSIT"

  3. 필드 마스크를 추가하여 원하는 응답 필드를 가져옵니다. 필요한 대중교통 경로 필드 요청을 참고하세요.

  4. 필요한 경우 선택적 매개변수를 설정합니다. 자세한 내용은 대중교통 경로의 매개변수 설정

필요한 대중교통 경로 필드 요청

필드 마스크를 사용하여 필요한 대중교통 경로 필드를 요청합니다. 다음 표 대중교통에 대한 몇 가지 추천 응답을 포함합니다. 경로 및 이를 요청하는 데 사용할 필드 마스크가 포함됩니다.

이 정보를 요청하려면 이 필드 마스크 사용
모든 경로 세부정보 routes.*
모든 대중교통 세부정보 routes.legs.steps.transitDetails
구간별 출발 위치 routes.legs.steps.startLocation
각 구간의 종료 위치 routes.legs.steps.endLocation
각 단계의 다중선 라우팅 routes.legs.steps.polyline
각 단계에 사용되는 대중교통 유형 routes.legs.steps.travelMode
각 단계 및 경로의 예상 요금 및 현지화된 예상 요금 routes.travel_advisory.transitFare localized routes.localizedValues.transitFare

참고: transitFare는 API가 모든 단계에 대한 대중교통 요금 정보를 결정할 수 있습니다.

시간 및 거리에 관한 현지화된 텍스트 routes.localizedValues

필드 마스크 설정에 대한 자세한 내용은 다음을 참조하세요. 반환할 필드를 선택합니다.

대중교통 경로의 매개변수 설정

다음은 대중교통 경로와 관련된 매개변수입니다.

요청할 작업 이 매개변수 사용 참고
대중교통 모드 선택 travelMode: "TRANSIT" 필수 항목입니다. 자세히 알아보기
도착 또는 출발 시간 설정 "arrivalTime": "yyyy-mm-ddThh:mm:ssZ"

또는

"departureTime": "yyyy-mm-ddThh:mm:ssZ"
선택사항입니다. arrival_time 또는 departure_time을 지정할 수 있습니다. 만약 두 시간 모두 지정되지 않은 경우 departure_time의 기본값은 현재 실행 시간 (now)입니다. 도착 시간 및 다음 시간대 내의 출발 시간은 현재 실행 시간 (now)을 참조로 사용합니다.
  • now 전 7일(양 끝값 포함)
  • now 이후 최대 100일
시간은 RFC3339 UTC 'Zulu'의 타임스탬프로 표시됩니다. 형식으로 입력합니다. 자세히 알아보기
대체 경로 포함 "computeAlternativeRoutes": true 선택사항입니다. Routes API가 최대 3을 계산하도록 true로 설정합니다. 추가 경로(가능한 경우) 자세히 알아보기
대중교통 유형에 대한 환경설정 지정 "transitPreferences": { allowedTravelModes: ["BUS","SUBWAY","TRAIN","LIGHT_RAIL","RAIL"]}

참고: 선호하는 이동 수단을 지정해도 반환된 경로에서 선호하는 이동 수단의 경로 효율성과 이용 가능 여부에 따라 다른 이동 수단을 사용하거나 다른 이동 수단만 사용할 수도 있습니다.

선택사항입니다. 선호하는 대중교통 이동 수단을 지정합니다. 자세히 알아보기
대중교통 경로에 대한 환경설정 지정 "transitPreferences": {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} 선택사항입니다. 대중교통 경로 환경설정을 지정합니다. 자세히 알아보기

예: 대중교통 경로 가져오기

다음 예에서는 다음 매개변수를 사용하여 대중교통 경로를 가져옵니다.

  • 기차로 이동하고 도보 이동을 최소화하는 환경설정을 지정합니다.

  • 대체 경로를 요청합니다.

  • 대중교통 세부정보를 반환하는 필드 마스크를 제공합니다.

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "address": "Humberto Delgado Airport, Portugal"
  },
  "destination": {
    "address": "Basílica of Estrela, Praça da Estrela, 1200-667 Lisboa, Portugal"
  },
  "travelMode": "TRANSIT",
  "computeAlternativeRoutes": true,
  "transitPreferences": {
     routingPreference: "LESS_WALKING",
     allowedTravelModes: ["TRAIN"]
  },
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.legs.steps.transitDetails' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

응답에는 두 경로의 route.legs.steps.transitDetails 필드가 표시됩니다.

{
  "routes": [
    {
    "legs": [
        {
        "steps": [
          {},
          {},
          {},
          {
          "transitDetails": {
            "stopDetails": {
            "arrivalStop": {
              "name": "Saldanha",
              "location": {
                "latLng": {
                  "latitude": 38.73532,
                  "longitude": -9.14543
                }
              }
            },
            "arrivalTime": "2023-08-26T10:49:42Z",
            "departureStop": {
              "name": "Aeroporto",
              "location": {
                "latLng": {
                  "latitude": 38.769047799999996,
                  "longitude": -9.1284593
                }
              }
            },
            "departureTime": "2023-08-26T10:32:10Z"
              },
              "localizedValues": {
              "arrivalTime": {
                  "time": {
                    "text": "11:49"
                  },
                  "timeZone": "Europe/Lisbon"
              },
              "departureTime": {
                "time": {
                  "text": "11:32"
                },
                "timeZone": "Europe/Lisbon"
              }
            },
              "headsign": "São Sebastião",
              "transitLine": {
                "agencies": [
                  {
                    "name": "Metropolitano de Lisboa, E.P.E.",
                    "phoneNumber": "+351 21 350 0115",
                    "uri": "https://www.metrolisboa.pt/"
                  }
                ],
                "name": "Vermelha",
                "color": "#f23061",
                "nameShort": "Vm",
                "textColor": "#000000",
                "vehicle": {
                  "name": {
                    "text": "Metrô"
                  },
                "type": "SUBWAY",
                "iconUri": "//maps.gstatic.com/mapfiles/transit/iw2/6/subway2.png"
                }
              },
              "stopCount": 11
            }
          },
        {},
        {
          "transitDetails": {
            "stopDetails": {
              "arrivalStop": {
                "name": "Rato",
                "location": {
                  "latLng": {
                    "latitude": 38.7201022,
                    "longitude": -9.1540562
                  }
              }
            },
            "arrivalTime": "2023-08-26T11:01:37Z",
            "departureStop": {
              "name": "Saldanha",
                "location": {
                  "latLng": {
                    "latitude": 38.73527,
                    "longitude": -9.1455200000000012
                  }
                }
              },
              "departureTime": "2023-08-26T10:57:57Z"
            },
            "localizedValues": {
              "arrivalTime": {
                "time": {
                  "text": "12:01"
                },
                "timeZone": "Europe/Lisbon"
              },
              "departureTime": {
                "time": {
                  "text": "11:57"
                },
                "timeZone": "Europe/Lisbon"
              }
            },
            "headsign": "Rato",
            "transitLine": {
              "agencies": [
                {
                "name": "Metropolitano de Lisboa, E.P.E.",
                "phoneNumber": "+351 21 350 0115",
                "uri": "https://www.metrolisboa.pt/"
                }
              ],
              "name": "Amarela",
              "color": "#f2c200",
              "nameShort": "Am",
              "textColor": "#000000",
              "vehicle": {
                "name": {
                  "text": "Metrô"
                },
                "type": "SUBWAY",
                "iconUri": "//maps.gstatic.com/mapfiles/transit/iw2/6/subway2.png"
              }
            },
            "stopCount": 4
          }
        },
        {},
        {},
        {},
        {},
        {},
        {}
        ]
      }
    ]
  }
]
}