Sản phẩm này đang ở
Trạng thái cũ. Kể từ tháng 10 năm 2026, bạn sẽ không thể bật Distance Matrix API (Phiên bản cũ) cho các dự án mới trên Google Cloud nữa. Các dự án hiện có vẫn được hỗ trợ đầy đủ. Để sử dụng các tính năng mới và cải thiện hiệu suất, hãy
di chuyển sang Routes API.
Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.
Làm quen với Distance Matrix API (cũ)
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Yêu cầu và phản hồi mẫu
Ví dụ này yêu cầu dữ liệu ma trận khoảng cách giữa Washington, DC và Thành phố New York, NY, ở định dạng JSON:
URL
https://maps.googleapis.com/maps/api/distancematrix/json
?destinations=New%20York%20City%2C%20NY
&origins=Washington%2C%20DC
&units=imperial
&key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Washington%2C%20DC&destinations=New%20York%20City%2C%20NY&units=imperial&key=YOUR_API_KEY'
Hãy làm thử! Kiểm tra yêu cầu này bằng cách nhập URL vào trình duyệt web của bạn – nhớ thay thế YOUR_API_KEY bằng khoá API thực tế của bạn. Phản hồi cho biết khoảng cách và thời gian giữa các điểm xuất phát và điểm đến được chỉ định.
Tìm hiểu cách tạo URL yêu cầu, bao gồm tất cả các tham số có sẵn.
Mã mẫu này có định dạng JSON và XML:
JSON
{
"destination_addresses": ["New York, NY, USA"],
"origin_addresses": ["Washington, DC, USA"],
"rows":
[
{
"elements":
[
{
"distance": { "text": "228 mi", "value": 367654 },
"duration": { "text": "3 hours 55 mins", "value": 14078 },
"status": "OK",
},
],
},
],
"status": "OK",
}
XML
OK
Washington, DC, USA
New York, NY, USA
OK
14078
3 hours 55 mins
367654
228 mi
Hãy xem hướng dẫn dành cho nhà phát triển để hiểu rõ phản hồi.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2026-10-21 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2026-10-21 UTC."],[],["The content demonstrates requesting distance data between Washington, DC, and New York City using the Google Maps Distance Matrix API. The request URL and cURL command are provided, requiring the user to replace `YOUR_API_KEY` with their own. The API returns distance (228 mi) and duration (3 hours 55 mins) data in both JSON and XML formats. Users can test the URL and further understand responses, and can learn to build custom URL requests through provided documentation.\n"]]