Route Matrix 클래스로 이전

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

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

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

거리 행렬 서비스 (기존)	RouteMatrix (베타)
필수 매개변수
origins	origins
destinations	destinations
선택적 매개변수
travelMode	travelMode
transitOptions	transitPreference
arrivalTime	arrivalTime
drivingOptions	departureTime, trafficModel
unitSystem	units
avoidHighways, avoidTolls	RouteModifiers

코드 비교

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

Directions 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 클래스 (베타)

다음 코드는 새 경로 매트릭스 클래스를 사용하여 거리 매트릭스 요청을 만듭니다.

// 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,));