This product or feature is in Legacy status. For more information about the Legacy stage and how to migrate from Legacy to newer services, seeLegacy products and features.
Try it!Test this request by entering the URL into your web browser - be sure
to replaceYOUR_API_KEYwithyour actual API key.
The response shows the distance and duration between the specified origins
and destinations.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 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)."]]
