Job Status Instructions FAQ

Submission Guide

Everything you need to know about preparing and submitting your distance matrix request.

Prepare Your CSV File

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 5MB file size limit.

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.

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.

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.

Upload or Drag & Drop Your File

  • Click to Upload
    • Press the big upload box labeled "Click to upload or drag and drop."
    • Select your CSV file from your computer.
  • Drag & Drop
    • Alternatively, drag your file from your file manager and drop it onto the upload box.
  • Verify File Size
    • Ensure it's <= 5MB. Larger files might be rejected or fail to process.

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.

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.

Contact Support

If you have questions or run into issues, please contact us at contact.distancematrix@gmail.com
Include details like your job ID or the CSV you uploaded so we can help troubleshoot quickly.