Aidbox
Ask or search…
K

Location search

Location search is used to search locations by coordinates using the WGS84 datum.
Geopositional search is supported in Aidbox only with Aidboxdb 15.3 and later.

Supported search parameters

Search parameter
Supported?
Description
near
km and [mi_us] units are supported
contains

Near Search Parameter

Search for locations near the specified geo-coded position.
GET [base]/Location?near=<latitude>|<longitude>|[distance]|[units]
Latitude and longitude are required.
If the units are omitted, then kms are assumed.
If the distance is also omitted, then Aidbox treat "near" as 3 km.

Examples

Get locations within 11.2 kms of the some geo-coded position:
# latitude |longitude|distance|units
GET /Location?near=-83.674810|42.266500|11.20|km
Response:
resourceType: Bundle
total: 1
entry:
- resource:
position:
latitude: -83.69481
longitude: 42.2565
id: >- loc-1
resourceType: Location
Search in miles:
GET /Location?near=-83.674810|42.266500|11.20|[mi_us]
Search without distance and units
# distance = 3, units = km
GET /Location?near=-83.674810|42.266500