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.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
Wprowadzenie do interfejsu Distance Matrix API (starsza wersja)
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ć YOUR_API_KEY prawdziwym kluczem API. Odpowiedź zawiera odległość i czas trwania podróży między określonymi miejscami wylotu i 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
OK
Washington, DC, USA
New York, NY, USA
OK
14078
3 hours 55 mins
367654
228 mi
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: 2026-04-29 UTC.
[null,null,["Ostatnia aktualizacja: 2026-04-29 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"]]