1. Prepare Your CSV File
1. Format Requirements
Your file can follow one of three formats:
Matrix Format:
id, lat, lon
➤ Output: If you provided N data points then you will receive a N
x N distance matrix and a N x N duration matrix as the output.
Source-Destination:
id, slat, slon, dlat, dlon
➤ Output: If you provided n data points then you will receive the
same dataset with 2 extra columns of distance and duration.
Tagged Format:
id, lat, lon, tag (source/destination)
➤ Output: If you provided N source data points and M destination
data points, then you will receive N x M distance and a N x M duration matrix as the output.
Make sure each row is valid latitude and longitude and the file is within the 10MB file size limit.
2. Download Sample Data
- Click the Input and Output button provided on the page to download sample CSV files.
- Open the sample in a spreadsheet editor or text editor to see the expected layout.
2. Select a Country
- From the "Select a Country" dropdown, choose the country whose road network you want to use for distance calculations.
- Make sure to select the right country otherwise the output might contain only NULL values.
3. Enter Your Email
- In the "Enter Your Email" box, type an address you have access to.
- This is where you'll receive confirmation that the job is completed.
4. Upload or Drag & Drop Your File
-
1. Click to Upload
- Press the big upload box labeled "Click to upload or drag and drop."
- Select your CSV file from your computer.
-
2. Drag & Drop
- Alternatively, you can drag your file from your file manager and drop it onto the upload box.
-
3. Verify File Size
- Ensure it's <= 10MB. Larger files might be rejected or fail to process.
5. Submit Your Request
- After the file is attached, hit the "Submit" button.
- The site begins processing your file to compute road distances using the specified coordinates. You can choose to save the job request ID to check the status of your job in the "JOB STATUS" page.
- Alternatively, on job completion you will also receive an email with the job request ID for you to download the output. You can then visit the "JOB STATUS" page to download the file.
6. Troubleshooting Tips
1
Check CSV Formatting
Even a small typo in column headers or missing commas can cause errors.
2
Check Email Spam / Junk Folder
If you don't see the results email, it might be filtered by your email provider.
3
Use "Job Status"
If the email is delayed, the Job Status page may already have the results. You will need the job request id to use the Job Status page.
7. Contact Support
If you have questions or run into issues, please contact us on contact.distancematrix@gmail.com
Include details like your job ID or the CSV you uploaded so they can help troubleshoot quickly.