Ta usługa lub funkcja ma stan „Stara”. Więcej informacji o etapach starszej wersji i o przechodzeniu z nich do nowszych usług znajdziesz w artykule
Stare produkty i funkcje.
Pierwsze kroki z interfejsem Distance Matrix API
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Przykładowe żądanie i odpowiedź
Ten przykład wysyła żądanie danych macierzy odległości między Waszyngtonem a Nowym Jorkiem w formacie 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'
Wypróbuj Przetestuj to żądanie, wpisując adres URL w przeglądarce. Pamiętaj, aby zastąpić ciąg YOUR_API_KEY swoim kluczem interfejsu API.
Odpowiedź zawiera odległość i czas trwania podróży między określonymi miejscami początkowymi a docelowymi.
Dowiedz się, jak tworzyć adresy URL żądań, w tym wszystkie dostępne parametry.
Ten przykładowy kod jest w formatach JSON i 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>
Zapoznaj się z przewodnikiem dla deweloperów, aby zrozumieć odpowiedź.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-31 UTC.
[null,null,["Ostatnia aktualizacja: 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)."]]
