Try it live
Type a place or address and pick a result from the dropdown. As you type, it runs a real GET /geocode/api call with a shared demo key (limited per day). Get your own key to go further.
How to use
1. Create a free API key. 2. Send it as Authorization: Bearer YOUR_KEY, or as ?key=YOUR_KEY. 3. Call one of the two endpoints.
Search: GET /geocode/api
curl "https://api.maplark.com/geocode/api?q=Gamla+Stan+Stockholm&limit=3" \
-H "Authorization: Bearer YOUR_KEY"const res = await fetch(
'https://api.maplark.com/geocode/api?q=Gamla+Stan+Stockholm&limit=3',
{ headers: { Authorization: 'Bearer YOUR_KEY' } },
);
const { features } = await res.json();
const [lon, lat] = features[0].geometry.coordinates; Reverse: GET /geocode/reverse
curl "https://api.maplark.com/geocode/reverse?lat=59.325&lon=18.071&limit=1" \
-H "Authorization: Bearer YOUR_KEY"Response
A GeoJSON FeatureCollection, ranked best match first. Coordinates are [lon, lat].
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": { "type": "Point", "coordinates": [18.0711, 59.3252] },
"properties": {
"osm_type": "R",
"osm_id": 1234567,
"name": "Gamla stan",
"city": "Stockholm",
"country": "Sweden",
"extent": [18.063, 59.328, 18.080, 59.322]
}
}
]
} Nominatim clients: /geocode/nominatim/
Already using Nominatim? Point your client at https://api.maplark.com/geocode/nominatim/ and add your key. /search, /reverse and /status take Nominatim's parameters and return xml, json, jsonv2, geojson or geocodejson. Requests count against the same monthly geocoding allowance.
curl "https://api.maplark.com/geocode/nominatim/search?q=Gamla+Stan+Stockholm&format=jsonv2&key=YOUR_KEY"
curl "https://api.maplark.com/geocode/nominatim/reverse?lat=59.325&lon=18.071&format=json&key=YOUR_KEY"from geopy.geocoders import Nominatim
geolocator = Nominatim(user_agent="my-app", domain="api.maplark.com/geocode/nominatim")
geolocator.headers["Authorization"] = "Bearer YOUR_KEY"
location = geolocator.geocode("Gamla Stan, Stockholm")
print(location.latitude, location.longitude)Parameters
| Param | Used by | What it does |
|---|---|---|
q | search | Place name or address. Required. Tolerates typos and partial input. |
lat, lon | both | Search: bias results toward this point. Reverse: the point to look up (required). |
limit | both | Max results, up to 50. |
bbox | search | Only results inside min_lon,min_lat,max_lon,max_lat. |
radius | reverse | Search radius in km, up to 5000. |
lang | both | Result language: default, en, de, fr, or it. |
osm_tag | both | Filter by OSM tag, e.g. osm_tag=amenity:cafe. Repeat to combine. |
layer | both | Restrict to city, street, house, and similar layers. |
- Get the shape. Each feature has
osm_type(N,W,R) andosm_id. Pass them to the OSM Features API (within=relation/<id>orosm_ids) for the full polygon. - Cost. No credits. Each plan includes monthly geocoding requests. See pricing.