GPS Utilities API v1.0

Calculate Closest and Farthest Distances

This endpoint requires a Start Coordinate which is then used to determine the Closest and Farthest distances between it, and each of the GPS coordinates provided in the List of coordinates.

The Response gives back the Closest and Farthest coordinates together with the distance measured from the start coordinate and that particular coordinate. You can elect to have the distance objects returned with all supported units of measurement.

The calculation uses the geodetic distance which takes into account the curvature of the earth. This is a 2d calculation which does not take elevation into consideration.

Marketplace: RapidAPI URL to this EndPoint

Authentication: Please see the requirements on the RapidAPI Portal.

Complete GPS Utils Endpoint List

Endpoint URL

POST [RapidAPI Base URL]/v1/distances-cf

Parameters

Parameter Required Description Data Type
startCoord.latitude Yes Starting coordinate latitude. Number (float)
startCoord.longitude Yes Starting coordinate longitude. Number (float)
coordinates Yes Array of coordinate objects. At least one object must be provided.
The item count is limited by the plan that is subscribed to on RapidAPI.		 Array of Objects
coordinates[].latitude Yes Latitude of a coordinate in the array. Number (float)
coordinates[].longitude Yes Longitude of a coordinate in the array. Number (float)
unit No Unit of measurement. Options: meters, miles, feet, km, nm, all. Default: meters. One can only request all of the units or one of the valid options. String
fmt No Format of returned data, Options: json (more coming soon). Default: json String
dec No Number of decimal places to use on the measurements. Options 0 to 6 Default: 5 Integer

POST [RapidAPI Base URL]/v1/distances-cf

Headers:

Please see the RapidAPI documentation

Body:


    {
        "startCoord": {
            "latitude": -33.991838,
            "longitude": 22.736900
        },
        "coordinates": [
            {
                "latitude": -33.988444,
                "longitude": 22.749813
            },
            {
                "latitude": -34.005652,
                "longitude": 22.758734
            },
            {
                "latitude": -33.988796,
                "longitude": 22.768931
            }
        ],
        "unit": "meters",
        "fmt": "json",
        "dec": 3
    }
                                                


    {
        "closest": {
            "latitude": -33.988444,
            "longitude": 22.749813,
            "distance": {
                "meters": 1251.089
            },
            "total": {}
        },
        "farthest": {
            "latitude": -33.988796,
            "longitude": 22.768931,
            "distance": {
                "meters": 2978.686
            },
            "total": {}
        },
        "unit": "meters"
    }