1Fetch Client API

<back to all web services

CalculateDistance

The following routes are available for this service:
POST/calculatedistanceCalculate 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; }
    }

}

Java CalculateDistance DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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: application/json
Content-Type: application/json
Content-Length: length

{"Coordinates":[{"Latitude":0,"Longitude":0}],"ApiKey":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"PointDistances":[0],"TotalDistance":0,"Description":"String","Heading":"String","WasSuccessful":false}