Locations

Locations_nearby_list

Return locations within a given radius of a center point. Results are ordered by distance (closest first), then by id. Each result includes a computed distance_km field.

GET
/api/v1/locations/nearby

Query Parameters

latnumber

Latitude of the center point (decimal degrees, -90 to 90)

Formatfloat
lonnumber

Longitude of the center point (decimal degrees, -180 to 180)

Formatfloat
page?integer

A page number within the paginated result set.

radius_kmnumber

Search radius in kilometers (must be positive)

Formatfloat
size?integer

Number of results to return per page.

Response Body

curl -X GET "https://loading/api/v1/locations/nearby?lat=0.1&lon=0.1&page=0&radius_km=0.1&size=0"
{
  "items": [
    [
      {
        "id": 0,
        "osm_brand_logo_url": "string",
        "distance_km": 0.1,
        "type": "OSM",
        "osm_id": 9223372036854776000,
        "osm_type": "NODE",
        "osm_name": "string",
        "osm_display_name": "string",
        "osm_tag_key": "string",
        "osm_tag_value": "string",
        "osm_brand": "string",
        "osm_address_postcode": "string",
        "osm_address_city": "string",
        "osm_address_country": "string",
        "osm_address_country_code": "string",
        "osm_lat": -9999,
        "osm_lon": -9999,
        "osm_version": 2147483647,
        "website_url": "http://example.com",
        "price_count": 2147483647,
        "user_count": 2147483647,
        "product_count": 2147483647,
        "proof_count": 2147483647,
        "source": "string",
        "created": "2019-08-24T14:15:22Z",
        "updated": "2019-08-24T14:15:22Z"
      }
    ]
  ],
  "page": 1,
  "pages": 16,
  "size": 100,
  "total": 1531
}