ย้ายข้อมูลไปยังคลาสเส้นทาง

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

ไลบรารี Routes ใหม่, Maps JavaScript API มีคลาส Route ซึ่งจะแทนที่บริการเส้นทางเดิม หน้านี้จะอธิบายความแตกต่างระหว่างบริการเส้นทางเดิมกับคลาส Route ใหม่ และแสดงโค้ดบางส่วนเพื่อเปรียบเทียบ

บริการเส้นทาง (เดิม) เทียบกับคลาส Route

พารามิเตอร์คำขอ

ตารางต่อไปนี้เปรียบเทียบพารามิเตอร์คำขอสำหรับบริการเส้นทางเดิมและคลาส Route

Directions Service (เดิม) Route
วิธี DirectionsService.route() วิธี Route.computeRoutes()

พารามิเตอร์ที่จำเป็น

origin origin
destination destination
travelMode travelMode (ไม่บังคับ)

พารามิเตอร์ที่ไม่บังคับ

optimizeWaypoints optimizeWaypointOrder
provideRouteAlternatives computeAlternativeRoutes
avoidFerries avoidHighways avoidTolls routeModifiers
drivingOptions departureTime, trafficModel
region region
transitOptions transitPreference
arrivalTime arrivalTime
unitSystem units
waypoints intermediates

การเปรียบเทียบวิธีการ

ตารางต่อไปนี้เปรียบเทียบเมธอดหลักสำหรับบริการเส้นทางเดิมและคลาส Route

Directions Service (เดิม) Route
วิธี route() วิธี computeRoutes()
วิธี DirectionsRenderer.setDirections() เมธอด createPolylines(), เมธอด createWaypointAdvancedMarkers()

การเปรียบเทียบโค้ด

ส่วนนี้จะเปรียบเทียบโค้ด 2 ชิ้นที่คล้ายกันเพื่อแสดงความแตกต่างระหว่างบริการเส้นทางเดิมกับคลาส Route ใหม่ ข้อมูลโค้ดแสดงโค้ดที่จำเป็นใน API ที่เกี่ยวข้องแต่ละรายการเพื่อส่งคำขอเส้นทาง จากนั้นใช้ผลลัพธ์เพื่อวาดเส้นประกอบและเครื่องหมายบนแผนที่

ในบริการเส้นทางเดิม ระบบจะใช้ออบเจ็กต์ DirectionsRenderer เพื่อแสดงเส้นประกอบและเครื่องหมายเพื่อแสดงผลลัพธ์เส้นทางบนแผนที่ ในไลบรารี Routes ออบเจ็กต์ DirectionsRenderer ถูกแทนที่ด้วยเมธอด createPolylines() และ createWaypointAdvancedMarkers() หน้านี้จะอธิบายความแตกต่างระหว่างบริการเส้นทางเดิมกับคลาส Route ใหม่ และแสดงโค้ดบางส่วนเพื่อเปรียบเทียบ

ขอเส้นทางการขับขี่

บริการเส้นทาง (เดิม)

โค้ดต่อไปนี้จะรับเส้นทางการขับขี่โดยใช้บริการเส้นทางเดิม จากนั้นใช้ DirectionsRenderer เพื่อวาดเส้นประกอบและเครื่องหมายบนแผนที่

// Define a simple request.
var request = {
  origin: 'Mountain View, CA',
  destination: 'San Francisco, CA',
  travelMode: 'DRIVING'
};
// Call the Directions Service to get the directions.
directionsService.route(request, function(result, status) {
  if (status == 'OK') {
    directionsRenderer.setDirections(result); // Add polyline and markers to the map.
  }
});

ระดับเส้นทาง

โค้ดต่อไปนี้จะรับเส้นทางการขับขี่โดยใช้คลาส Route ใหม่ จากนั้นใช้เมธอด createPolylines เพื่อวาดเส้นประกอบบนแผนที่ และใช้เมธอด createWaypointAdvancedMarkers เพื่อวาดเครื่องหมายบนแผนที่

คลาส Route ใหม่จะไม่แสดงผลเครื่องหมายโดยอัตโนมัติ คุณต้องเรียกใช้ createWaypointAdvancedMarkers เพื่อแสดงผลเครื่องหมาย

TypeScript

// Define a routes request.
const request: google.maps.routes.ComputeRoutesRequest = {
    origin: 'Mountain View, CA',
    destination: 'San Francisco, CA',
    travelMode: 'DRIVING',
    fields: ['path'], // Request fields needed to draw polylines.
};

// Call computeRoutes to get the directions.
const { routes } = await Route.computeRoutes(request);

// Use createPolylines to create polylines for the route.
if (!routes) {
    console.warn('No routes found.');
    return;
}
mapPolylines = routes[0].createPolylines();
// Add polylines to the map.
mapPolylines.forEach((polyline) => {
    polyline.setMap(map);
});

// Create markers to start and end points.
const markers = await routes[0].createWaypointAdvancedMarkers();
// Add markers to the map
markers.forEach((marker) => {
    marker.map = map;
});

JavaScript

// Define a routes request.
const request = {
    origin: 'Mountain View, CA',
    destination: 'San Francisco, CA',
    travelMode: 'DRIVING',
    fields: ['path'], // Request fields needed to draw polylines.
};

// Call computeRoutes to get the directions.
const { routes } = await Route.computeRoutes(request);

// Use createPolylines to create polylines for the route.
if (!routes) {
    console.warn('No routes found.');
    return;
}
mapPolylines = routes[0].createPolylines();
// Add polylines to the map.
mapPolylines.forEach((polyline) => {
    polyline.setMap(map);
});

// Create markers to start and end points.
const markers = await routes[0].createWaypointAdvancedMarkers();
// Add markers to the map
markers.forEach((marker) => {
    marker.map = map;
});