Sản phẩm hoặc tính năng này đang ở trạng thái Cũ. Để biết thêm thông tin về giai đoạn Cũ và cách di chuyển từ các dịch vụ Cũ sang các dịch vụ mới hơn, hãy xem phần
Các sản phẩm và tính năng cũ.
Bắt đầu sử dụng API Ma trận từ xa
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 thử yêu cầu này bằng cách nhập URL vào trình duyệt web – 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 lượng giữa điểm khởi hành 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 thông số có sẵn.
Mã mẫu này ở đị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
<DistanceMatrixResponse>
<status>OK</status>
<origin_address>Washington, DC, USA</origin_address>
<destination_address>New York, NY, USA</destination_address>
<row>
<element>
<status>OK</status>
<duration>
<value>14078</value>
<text>3 hours 55 mins</text>
</duration>
<distance>
<value>367654</value>
<text>228 mi</text>
</distance>
</element>
</row>
</DistanceMatrixResponse>
Tham khảo hướng dẫn dành cho nhà phát triển để hiểu 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: 2025-08-31 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\u003cp\u003eThis page provides a sample request and response for the Distance Matrix API, demonstrating how to calculate the distance and travel time between two locations.\u003c/p\u003e\n"],["\u003cp\u003eThe example uses Washington, DC and New York City, NY as locations and showcases the request URL, cURL command, and expected JSON/XML responses.\u003c/p\u003e\n"],["\u003cp\u003eUsers are encouraged to try the example with their own API key and explore further documentation on building requests and understanding responses.\u003c/p\u003e\n"]]],["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"],null,["# Get started with the Distance Matrix API\n\nSample request and response\n---------------------------\n\nThis example requests the distance matrix data between Washington, DC and\nNew York City, NY, in JSON format:\n\n\u003cbr /\u003e\n\n### URL\n\n```scdoc\nhttps://maps.googleapis.com/maps/api/distancematrix/json\n ?destinations=New%20York%20City%2C%20NY\n &origins=Washington%2C%20DC\n &units=imperial\n &key=YOUR_API_KEY\n```\n\n### cURL\n\n```bash\ncurl -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'\n```\n\n\u003cbr /\u003e\n\n**Try it!** Test this request by entering the URL into your web browser - be sure\nto replace `YOUR_API_KEY` with [your actual API key](/maps/documentation/distance-matrix/get-api-key).\nThe response shows the distance and duration between the specified origins\nand destinations.\n\nLearn how to [build request URLs](/maps/documentation/distance-matrix/distance-matrix),\nincluding all available parameters.\n\nThis code sample is in JSON and XML formats:\n\n\u003cbr /\u003e\n\n### JSON\n\n```json\n{\n \"destination_addresses\": [\"New York, NY, USA\"],\n \"origin_addresses\": [\"Washington, DC, USA\"],\n \"rows\":\n [\n {\n \"elements\":\n [\n {\n \"distance\": { \"text\": \"228 mi\", \"value\": 367654 },\n \"duration\": { \"text\": \"3 hours 55 mins\", \"value\": 14078 },\n \"status\": \"OK\",\n },\n ],\n },\n ],\n \"status\": \"OK\",\n}\n```\n\n### XML\n\n```xml\n\u003cDistanceMatrixResponse\u003e\n \u003cstatus\u003eOK\u003c/status\u003e\n \u003corigin_address\u003eWashington, DC, USA\u003c/origin_address\u003e\n \u003cdestination_address\u003eNew York, NY, USA\u003c/destination_address\u003e\n \u003crow\u003e\n \u003celement\u003e\n \u003cstatus\u003eOK\u003c/status\u003e\n \u003cduration\u003e\n \u003cvalue\u003e14078\u003c/value\u003e\n \u003ctext\u003e3 hours 55 mins\u003c/text\u003e\n \u003c/duration\u003e\n \u003cdistance\u003e\n \u003cvalue\u003e367654\u003c/value\u003e\n \u003ctext\u003e228 mi\u003c/text\u003e\n \u003c/distance\u003e\n \u003c/element\u003e\n \u003c/row\u003e\n\u003c/DistanceMatrixResponse\u003e\n```\n\n\u003cbr /\u003e\n\nCheck the developer's guide to [understand the response](/maps/documentation/distance-matrix/distance-matrix#distance-matrix-responses)."]]