انتقال به کلاس Route Matrix

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

کلاس RouteMatrix جایگزین Distance Matrix Service, Maps JavaScript API (Legacy) می‌شود. این صفحه تفاوت‌های بین سرویس قدیمی Distance Matrix و کتابخانه جدید JavaScript را توضیح می‌دهد و کدهایی را برای مقایسه ارائه می‌کند.

Distance Matrix API (Legacy) versus Route Matrix class

جدول زیر پارامترهای درخواست را برای Distance Matrix API (Legacy) قدیمی و کلاس RouteMatrix مقایسه می‌کند.

Distance Matrix Service, Maps JavaScript API (Legacy) RouteMatrix ضروری یا اختیاری
origins origins الزامی
destinations destinations الزامی
travelMode travelMode اختیاری
transitOptions transitPreference اختیاری
arrivalTime arrivalTime اختیاری
drivingOptions departureTime، trafficModel اختیاری
unitSystem units اختیاری
avoidHighways، avoidTolls RouteModifiers اختیاری

مقایسه کد

این بخش دو قطعه کد مشابه را مقایسه می‌کند تا تفاوت‌های بین Distance Matrix API (Legacy) و کلاس جدید RouteMatrix را نشان دهد. تکه‌کدها نشان می‌دهند کد موردنیاز در هر میانای برنامه‌سازی کاربردی مربوطه برای درخواست مسیر و مشاهده نتایج چیست.

Distance Matrix API (Legacy)

کد زیر بااستفاده از 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,));