Everything you need to know about the distance matrix tool.
CSV Upload
Three formats are accepted: Matrix (id, lat, lon), Source-Destination (id, slat, slon, dlat, dlon), and Tagged (id, lat, lon, tag).
Files must be 5MB or smaller — larger datasets may need to be split into multiple jobs.
Yes, selecting the correct country from the dropdown ensures distances are calculated on the right road network.
Yes, you can download sample input and output files directly from the submission page to see the expected layout before uploading your own data.
Even a small typo in column headers or a missing comma can cause the job to fail, so double-check formatting against the sample file before submitting.
Processing
You'll receive an email notification once processing completes, and you can check progress anytime on the Job Status page using your job request ID.
Your output will contain only NULL values instead of valid data — double-check the country selection before submitting.
No, processing is currently free for all users, with no paid tier introduced yet.
Use an email address you actively check, since that's where the job completion notification and download link are sent.
Check your spam or junk folder first, since notification emails are sometimes filtered there — if it's still missing, the Job Status page may already show your results.
Output
For N data points, you'll receive an N x N distance matrix and an N x N duration matrix between every pair of locations.
You can download the output file from the Job Status page using your job request ID, or via the link in your completion email.
NULL values usually mean the wrong country was selected during submission — resubmit with the correct country selected.
You'll receive the same dataset you submitted, with two extra columns added for distance and duration between each source-destination pair.
For N source points and M destination points, you'll receive an N x M distance matrix and an N x M duration matrix between the two groups.