| POST | /calculatedistance | Calculate the distance between a list of coordinates |
|---|
import java.math.*;
import java.util.*;
import net.servicestack.client.*;
public class dtos
{
public static class CalculateDistance extends ApiServiceRequest implements ILogRequest
{
/**
* Array of coordinates
*/
@ApiMember(Description="Array of coordinates", IsRequired=true)
public ArrayList<Coordinate> Coordinates = null;
public ArrayList<Coordinate> getCoordinates() { return Coordinates; }
public CalculateDistance setCoordinates(ArrayList<Coordinate> value) { this.Coordinates = value; return this; }
}
public static class ApiServiceRequest implements IServiceRequest, IHasApiKey
{
/**
* The API Key required for authentication
*/
@ApiMember(DataType="string", Description="The API Key required for authentication", IsRequired=true)
public String ApiKey = null;
public String getApiKey() { return ApiKey; }
public ApiServiceRequest setApiKey(String value) { this.ApiKey = value; return this; }
}
public static class Coordinate
{
/**
* The Latitude
*/
@ApiMember(Description="The Latitude", IsRequired=true)
public Double Latitude = null;
/**
* The Longitude
*/
@ApiMember(Description="The Longitude", IsRequired=true)
public Double Longitude = null;
public Double getLatitude() { return Latitude; }
public Coordinate setLatitude(Double value) { this.Latitude = value; return this; }
public Double getLongitude() { return Longitude; }
public Coordinate setLongitude(Double value) { this.Longitude = value; return this; }
}
public static class CalculateDistanceResponse extends ApiServiceResponse
{
/**
* A list of the distances between each point, returned in order that the points were provided
*/
@ApiMember(Description="A list of the distances between each point, returned in order that the points were provided")
public ArrayList<BigDecimal> PointDistances = null;
/**
* The total distance between all points
*/
@ApiMember(Description="The total distance between all points")
public BigDecimal TotalDistance = null;
public ArrayList<BigDecimal> getPointDistances() { return PointDistances; }
public CalculateDistanceResponse setPointDistances(ArrayList<BigDecimal> value) { this.PointDistances = value; return this; }
public BigDecimal getTotalDistance() { return TotalDistance; }
public CalculateDistanceResponse setTotalDistance(BigDecimal value) { this.TotalDistance = value; return this; }
}
public static class ApiServiceResponse implements IServiceResponse
{
/**
* Information about the response.
*/
@ApiMember(Description="Information about the response.", IsRequired=true)
public String Description = null;
/**
* Heading or summary of the response.
*/
@ApiMember(Description="Heading or summary of the response.", IsRequired=true)
public String Heading = null;
/**
* Did the intended operation for this response complete successfully?
*/
@ApiMember(DataType="boolean", Description="Did the intended operation for this response complete successfully?", IsRequired=true)
public Boolean WasSuccessful = null;
public String getDescription() { return Description; }
public ApiServiceResponse setDescription(String value) { this.Description = value; return this; }
public String getHeading() { return Heading; }
public ApiServiceResponse setHeading(String value) { this.Heading = value; return this; }
public Boolean isWasSuccessful() { return WasSuccessful; }
public ApiServiceResponse setWasSuccessful(Boolean value) { this.WasSuccessful = value; return this; }
}
}
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /calculatedistance HTTP/1.1
Host: 1fetch.api.client.prod.86degrees.com
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length
{
Coordinates:
[
{
Latitude: 0,
Longitude: 0
}
],
ApiKey: String
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length
{
PointDistances:
[
0
],
TotalDistance: 0,
Description: String,
Heading: String,
WasSuccessful: False
}