폴리라인 작업

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

computeRoutes 메서드는 대답의 일부로 폴리라인으로 표시된 경로를 반환합니다. 다음 두 가지 유형의 폴리라인을 요청할 수 있습니다.

  • 기본 다중선 (기본값): 경로를 나타내지만 다중선에 교통정보가 삽입되어 있지 않습니다. 기본 폴리라인을 반환하는 요청은 Routes Basic 요율로 청구됩니다. Routes API 결제에 대해 자세히 알아보세요.
  • 교통 상황을 고려한 다중선에는 경로를 따라 교통 상황에 관한 정보가 포함됩니다. 교통 상황은 다중선의 특정 구간에 적용되는 속도 카테고리 (NORMAL, SLOW, TRAFFIC_JAM)로 표현됩니다. 교통 상황을 고려한 폴리라인 요청에는 Routes Preferred 요금이 청구됩니다. Routes API 결제에 대해 자세히 알아보세요.
  • 멀티모달 폴리라인에는 대중교통 세부정보와 교통정보가 포함됩니다. 멀티모달 폴리라인 요청에는 Routes Preferred 요금이 청구됩니다. Routes API 결제에 대해 자세히 알아보세요.

기본 폴리라인 (기본값)

다중선은 Polyline 객체로 표현되고, 경로는 LatLngAltitude 좌표의 배열입니다. 기본 폴리라인을 반환하려면 fields 속성이 path로 설정된 computeRoutes 메서드를 호출한 다음 경로 인스턴스에서 createPolylines 메서드를 호출하여 Polyline 객체를 가져옵니다.

다음 예에서는 기본 폴리라인을 요청하는 방법을 보여줍니다.

// Define a basic routes request.
const requestWithBasicPolyline = {
  origin: '155 Steuart St, San Francisco, CA 94105',
  destination: '450 Powell St, San Francisco, CA 94102',
  travelMode: 'WALKING',
  fields: ['path'],  // Request path field to get a polyline.
};

교통 상황 인식 다중선

교통 상황을 고려한 폴리라인을 요청하려면 요청에 다음 속성을 추가하세요.

  1. travelMode 속성을 DRIVING로 설정합니다.
  2. routingPreference 속성을 TRAFFIC_AWARE로 설정합니다.
  3. extraComputations 속성을 TRAFFIC_ON_POLYLINE로 설정합니다.
  4. path, speedPaths, routeLabels 필드를 지정합니다.

다음 예에서는 교통 상황을 고려한 폴리라인을 요청하는 방법을 보여줍니다.

// Define a traffic aware routes request.
const requestWithTraffic = {
  origin: '200 King St San Francisco, CA 94107',
  destination: 'Pier 41, San Francisco, CA 94133',
  travelMode: 'DRIVING',
  routingPreference: 'TRAFFIC_AWARE',
  extraComputations: ['TRAFFIC_ON_POLYLINE'],
  fields: ['speedPaths'],
};

지도에 다중선 표시

지도에 다중선을 표시하려면 경로 객체에서 createPolylines를 호출한 다음 setMap 메서드를 사용하여 다중선의 지도를 지도 객체로 설정합니다. 지도 객체는 지도에 다중선을 표시하는 데 사용됩니다.

다음 예는 지도에 폴리라인을 표시하는 방법을 보여줍니다.

  // Call createPolylines to create polylines for the first route.
  mapPolylines = routes[0].createPolylines();
  // Add polylines to the map.
  mapPolylines.forEach((polyline) => polyline.setMap(map));