به کلاس Route Matrix مهاجرت کنید

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

Distance Matrix API (Legacy) در مقابل کلاس Route Matrix (بتا)

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

سرویس ماتریس فاصله (ارثی)	RouteMatrix (بتا)
پارامترهای مورد نیاز
origins	origins
destinations	destinations
پارامترهای اختیاری
travelMode	travelMode
transitOptions	transitPreference
arrivalTime	arrivalTime
drivingOptions	departureTime , trafficModel
unitSystem	units
avoidHighways ، avoidTolls	RouteModifiers

مقایسه کدها

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

Directions API (Legacy)

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