Route Matrix 클래스로 이전

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

RouteMatrix 클래스는 Maps JavaScript API의 거리 행렬 서비스 (기존)를 대체합니다. 이 페이지에서는 기존 거리 행렬 서비스와 새 JavaScript 라이브러리의 차이점을 설명하고 비교를 위한 코드를 제공합니다.

Distance Matrix API (기존)와 Route Matrix 클래스 비교

다음 표에서는 기존 Distance Matrix API (기존)와 RouteMatrix 클래스의 요청 매개변수를 비교합니다.

Maps JavaScript API의 거리 행렬 서비스 (기존) RouteMatrix 필수 또는 선택사항
origins origins 필수
destinations destinations 필수
travelMode travelMode 선택사항
transitOptions transitPreference 선택사항
arrivalTime arrivalTime 선택사항
drivingOptions departureTime, trafficModel 선택사항
unitSystem units 선택사항
avoidHighways, avoidTolls RouteModifiers 선택사항

코드 비교

이 섹션에서는 두 개의 유사한 코드를 비교하여 Distance Matrix API (기존)와 새로운 RouteMatrix 클래스의 차이점을 보여줍니다. 코드 스니펫은 각 API에서 경로 요청을 하고 결과를 보는 데 필요한 코드를 보여줍니다.

Distance Matrix API (기존)

다음 코드는 Distance Matrix API (기존)를 사용하여 거리 행렬 요청을 수행합니다. 

// Define the request.
const request = {
  origins: [{lat: 55.93, lng: -3.118}, 'Greenwich, England'],
  destinations: ['Stockholm, Sweden', {lat: 50.087, lng: 14.421}],
  travelMode: 'DRIVING',
  drivingOptions: {
    departureTime: new Date(Date.now()),
    trafficModel: 'optimistic'
  }
};

// Make the request.
service.getDistanceMatrix(request).then((response) => {
  // Display the response.
  document.getElementById("response").textContent = JSON.stringify(
    response,
    null,
    2,
  );
});

Route Matrix 클래스

다음 코드는 새 Route Matrix 클래스를 사용하여 거리 행렬을 요청합니다. 

// Define the request.
const request = {
  origins: [{lat: 55.93, lng: -3.118}, 'Greenwich, England'],
  destinations: ['Stockholm, Sweden', {lat: 50.087, lng: 14.421}],
  travelMode: 'DRIVING',
  departureTime: new Date(),
  trafficModel: 'optimistic'
};

// Make the request.
const response = await RouteMatrix.computeRouteMatrix(request);

// Display the response.
document.getElementById("response").setValue(JSON.stringify(response, null, 2,));