Este producto o función tiene el estado Heredado. Para obtener más información sobre la etapa heredada y cómo migrar de los servicios heredados a servicios más nuevos, consulta
Productos y funciones heredados.
Comienza a usar la API de Distance Matrix
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Ejemplo de solicitud y respuesta
En este ejemplo, se solicitan los datos de la matriz de distancias entre Washington, D.C., y la ciudad de Nueva York, Nueva York, en formato 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'
Pruébalo Para probar esta solicitud, ingresa la URL en tu navegador web. Asegúrate de reemplazar YOUR_API_KEY
por tu clave de API real.
La respuesta muestra la distancia y la duración entre los orígenes y los destinos especificados.
Aprende a crear URLs de solicitudes, incluidos todos los parámetros disponibles.
Esta muestra de código está en formatos JSON y 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>
Consulta la guía para desarrolladores para comprender la respuesta.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-31 (UTC)
[null,null,["Última actualización: 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)."]]