Sign in

v1

latestOpenAPI 3.1.22026-08-063221.7 KB
Multipoint Distance Retriever

Get distance with one or more points

Find the distance and general drive time between multiple points.

get/getDistanceMultipoint

Query parameters

idstring password required

Required. The License Key issued by Melissa.

optstring

Options - List options in the following format, with multiple options delimited with a ,. For example: optionName:parameter,optionName:parameter. These options are case-sensitive and camel case.

  • arriveAt:< yyyy-mm-ddThh:mm:ss.mmmZ > - Specify the arrival time ISO 8601 UTC.

  • avoid:< borderCrossings | ferries | tollRoads | tunnels | unpavedRoads > - Specify the types of transport obstacles to avoid.

  • departAt:< yyyy-mm-ddThh:mm:ss.mmmZ | now > - Specify the departure date and time in ISO 8601 UTC. Default is now - departs immediately.

  • routeType:< eco | fastest | shortest | thrilling > - Specify the type of route.

    • eco - Balances travel time and fuel efficiency.
    • fastest - Optimizes for fastest travel time.
    • shortest - Optimizes for shortest travel distance.
    • thrilling - Optimized for challenging, hilly, or winding routes.

  • traffic:< false | true > - Considers current traffic conditions. Default is true.

  • travelMode:< bicycle | car | pedestrian > - Specify the type of vehicle used for the travel mode. Default is car.

  • vehicleCommercial:< false | true > - Indicates if the vehicle is a commercial vehicle. Default is false.

  • vehicleHeight:< [float] | 0 > - Specifies the vehicle height in meters. There are no height restrictions. Default is 0.

  • vehicleLength:< [float] | 0 > - Specifies the vehicle length in meters. Default is 0.

  • vehicleMaxSpeed:< [integer] | 0 > - Specifies the maximum vehicle speed in km/hr. Default is 0.

  • vehicleWeight:< [integer] | 0 > - Specifies the vehicle weight in kilograms. Minimum value is 1.

tstring

Transmission Reference - Serves as a unique request identifier. It is returned as sent.

units'mi' | 'km'

Units - This specifies the returned distance unit scale. Use mi for miles and km for kilometers.

pointsstring required

Required. Points are a series of Latitude,Longitude sets. Each Latitude is separated from its Longitude by the standard comma. Each set is delimited by a colon :, for example: lat1,long1:lat2,long2:lat3,long3:lat4,long4 calculated the time and distance between starting point 1 and destination 4 with stops 2 and 3 in between.

Headers

Accept'application/json' | '*/*' required

Format of the response.

Content-Type'application/json' | 'application/xml' required

Format of the request.

Response

Default response from a multipoint GET request

Resultsstring

Comma delimited status, error codes, and change codes for the record. For more information, see Street Route Result Codes.

Unitsstring

This is a string value that is the set unit of measurement for the TotalDrivingDistance field.

TransmissionResultsstring

Lists error codes from any errors caused by the most recent request as a whole. For more information, see Street Route Result Codes.

TravelTimestring

This is a string value of the travel time for the record in the format hh:mm:ss.

TotalDrivingDistancestring

This is a string value with the total driving distance. Refer to the Units field to know what unit of measurement it is.

TransmissionReferencestring

A pass-through of the input TransmissionReference field.

Versionstring

The current service version number.