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
}