API Reference

Search locations within a rectangle

post
https://{environment}.plugsurfing.com/emp/v1/geosearch/rectangle

Search for charging locations within a specified rectangle defined by two diagonal points. Returns up to 300 locations.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
double
required
-90 to 90

Latitude of the top edge of the rectangle in decimal degrees (e.g. N58°30' is represented as 58.5). Must be greater than bottomLatitude.

double
required
-90 to 90

Latitude of the bottom edge of the rectangle in decimal degrees (e.g. S58°30' is represented as -58.5)

double
required
-180 to 180

Longitude of the left edge of the rectangle in decimal degrees (e.g. E014°45' is represented as 14.75). Must be less than rightLongitude.

double
required
-180 to 180

Longitude of the right edge of the rectangle in decimal degrees (e.g. E014°45' is represented as 14.75)

number
≤ 300
Defaults to 300

Number of locations returned in the response (doesn't apply when aggregation is enabled)

boolean
Defaults to false

If true, the results will be aggregated. For large radius it makes the response much faster.

integer
2 to 9

Value between 2 and 9. The bigger value is, the smaller is the cell size of the grid for aggregation. If not passed, a default value, based on radius, is assumed.

string
length between 2 and 2

Supported languages: en, bg, cy, de, es, fi, fr, hu, is, it, lt, nb, nl, pl, pt, ro, sv.

Body Params
filters
object

Filtering criteria for location selection.

options
object

Additional options controlling search behavior.

Responses

Updated about 2 months ago

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago