Dieses Produkt oder diese Funktion ist eingestellt. Weitere Informationen zur Legacy-Phase und zur Migration von Legacy- zu neueren Diensten finden Sie unter
Legacy-Produkte und ‑Funktionen.
Erste Schritte mit der Distance Matrix API
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Beispielanforderung und -antwort
In diesem Beispiel werden die Daten der Distanzmatrix zwischen Washington, DC und New York City, NY, im JSON-Format angefordert:
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'
Testen! Testen Sie diese Anfrage, indem Sie die URL in Ihren Webbrowser eingeben. Achten Sie darauf, YOUR_API_KEY
durch Ihren tatsächlichen API-Schlüssel zu ersetzen.
In der Antwort werden die Entfernung und Dauer zwischen den angegebenen Start- und Zielorten angezeigt.
Informationen zum Erstellen von Anfrage-URLs, einschließlich aller verfügbaren Parameter
Dieses Codebeispiel ist im JSON- und XML-Format verfügbar:
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>
Weitere Informationen finden Sie im Entwicklerleitfaden unter Antworten verstehen.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]