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

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

کلاس 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,));