The Global Distance Finder API takes an input of an origin location and one or more destination locations, and returns road-based distance and travel times for each of them. When crossing bodies of water, ferry transport will be taken into consideration where data is available.
curl --request POST \
--url https://api.addressy.com/LocationServices/DistanceFinder/Nearby/v1.10/json6.ws \
--header 'Content-Type: application/json' \
--data '{
"Key": "<string>",
"AddressId": "<string>",
"LocationListId": "<string>",
"Locations": [
{
"Id": "<string>",
"Name": "<string>",
"Description": "<string>",
"Address": "<string>",
"Country": "<string>",
"Latitude": "<string>",
"Longitude": "<string>",
"MetaInfo": {},
"UnstructuredMetaInfo": {},
"OpeningHours": {
"Monday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Tuesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Wednesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Thursday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Friday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Saturday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Sunday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
}
}
}
],
"OriginLocation": {
"Id": "<string>",
"Name": "<string>",
"Description": "<string>",
"Address": "<string>",
"Country": "<string>",
"Latitude": "<string>",
"Longitude": "<string>",
"MetaInfo": {},
"UnstructuredMetaInfo": {},
"OpeningHours": {
"Monday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Tuesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Wednesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Thursday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Friday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Saturday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Sunday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
}
}
},
"MaxDistance": 123,
"InputUnit": 0,
"MaxResults": 123,
"OrderBy": 0,
"TransportationType": 0
}'
{
"OriginLocation": {
"Id": "<string>",
"Name": "<string>",
"Description": "<string>",
"Address": "<string>",
"Country": "<string>",
"Latitude": "<string>",
"Longitude": "<string>",
"MetaInfo": {},
"UnstructuredMetaInfo": {},
"OpeningHours": {
"Monday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Tuesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Wednesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Thursday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Friday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Saturday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Sunday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
}
}
},
"DestinationLocations": [
{
"DestinationLocation": {
"Id": "<string>",
"Name": "<string>",
"Description": "<string>",
"Address": "<string>",
"Country": "<string>",
"Latitude": "<string>",
"Longitude": "<string>",
"MetaInfo": {},
"UnstructuredMetaInfo": {},
"OpeningHours": {
"Monday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Tuesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Wednesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Thursday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Friday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Saturday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Sunday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
}
}
},
"Distance": "<string>",
"DistanceMiles": "<string>",
"DistanceMeters": 123,
"Time": "<string>",
"TimeSeconds": 123
}
]
}
Success
The response is of type object
.
curl --request POST \
--url https://api.addressy.com/LocationServices/DistanceFinder/Nearby/v1.10/json6.ws \
--header 'Content-Type: application/json' \
--data '{
"Key": "<string>",
"AddressId": "<string>",
"LocationListId": "<string>",
"Locations": [
{
"Id": "<string>",
"Name": "<string>",
"Description": "<string>",
"Address": "<string>",
"Country": "<string>",
"Latitude": "<string>",
"Longitude": "<string>",
"MetaInfo": {},
"UnstructuredMetaInfo": {},
"OpeningHours": {
"Monday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Tuesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Wednesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Thursday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Friday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Saturday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Sunday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
}
}
}
],
"OriginLocation": {
"Id": "<string>",
"Name": "<string>",
"Description": "<string>",
"Address": "<string>",
"Country": "<string>",
"Latitude": "<string>",
"Longitude": "<string>",
"MetaInfo": {},
"UnstructuredMetaInfo": {},
"OpeningHours": {
"Monday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Tuesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Wednesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Thursday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Friday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Saturday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Sunday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
}
}
},
"MaxDistance": 123,
"InputUnit": 0,
"MaxResults": 123,
"OrderBy": 0,
"TransportationType": 0
}'
{
"OriginLocation": {
"Id": "<string>",
"Name": "<string>",
"Description": "<string>",
"Address": "<string>",
"Country": "<string>",
"Latitude": "<string>",
"Longitude": "<string>",
"MetaInfo": {},
"UnstructuredMetaInfo": {},
"OpeningHours": {
"Monday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Tuesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Wednesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Thursday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Friday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Saturday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Sunday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
}
}
},
"DestinationLocations": [
{
"DestinationLocation": {
"Id": "<string>",
"Name": "<string>",
"Description": "<string>",
"Address": "<string>",
"Country": "<string>",
"Latitude": "<string>",
"Longitude": "<string>",
"MetaInfo": {},
"UnstructuredMetaInfo": {},
"OpeningHours": {
"Monday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Tuesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Wednesday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Thursday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Friday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Saturday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
},
"Sunday": {
"Open": "<string>",
"Close": "<string>",
"Information": "<string>"
}
}
},
"Distance": "<string>",
"DistanceMiles": "<string>",
"DistanceMeters": 123,
"Time": "<string>",
"TimeSeconds": 123
}
]
}