GeoAnalytics Builder account required

Distance Matrix One to Many

onetomany.{xml | json}

This service computes distances and time between one start point and many other waypoints.

A distance request has two required parameters: startpoints and waypoints which hold the coordinates. A distance request must be formatted as follow:


  • key: Your account key
  • output: The response format. May be either of the following values:
    • .json output in JavaScript Object Notation (JSON)
    • .xml output as XML
The service is available using HTTPS protocol. The HTTPS verb must be GET or POST. We advise to use POST if the number of waypoints exceeding 5.

List of parameters

Name Type Values Description
startpoint string e.g. 2.399086,48.717017 The longitude and the latitude of the starting point, separated by comma.{lg},{lt}. This is a mandatory field.
waypoints string e.g. n:point1;ll:2.33,48.88|n:point2;ll:2.34,49.88 An array of way points including Name, Longitude, Latitude.n:{name1};ll:{longitude1},{latitude1}|n:{name2};ll:{longitude2},{latitude2}. This is a mandatory field.
startname string e.g. Start The name of the starting point (the one given into startpoint parameter). This is a mandatory field.
travelmode string vehicle | pedestrian The travel mode used for computing the itinerary
unitsystem string metricandimperial | metric | imperial The unit system(s) to use for the result
avoidtollroad boolean true | false Avoid toll roads
avoidhighways boolean true | false Avoid highways
Send Request



  • Segments Contains the result of computation between the startpoint and waypoint, distance and time remaining to the that segment.
  • Failed Contains the waypoint(s) unable to being computed.