Adrese
Streets
GET/v1/geo/streets
The pieces of Moldova's streets in OpenStreetMap whose name starts as `q`, without the street's kind and diacritics ('bd. Stefan cel Mare' finds 'Bulevardul Ștefan cel Mare și Sfânt'), one row per about a kilometre of street, with the town each lies in. `near` and `radius` keep those around a point, nearest first. ODbL: every answer carries the credit, and a database made from it stays under the ODbL. Costs 2 credits per 50 rows.
Parametri
-
qstringobligatoriuCuvinte de căutat.
-
nearstringopționalUn punct: lat,lon.
-
radiusintegeropționalimplicit 15000Raza în metri, cel mult 20000.
-
pageintegeropționalimplicit 1Pagina, de la 1.
Erori posibile
curl "https://api.satelit.md/v1/geo/streets?q=Ismail" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/geo/streets?q=Ismail", {
headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits); import json, os, urllib.request
req = urllib.request.Request(
"https://api.satelit.md/v1/geo/streets?q=Ismail",
headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
body = json.load(res)
print(body["data"], body["meta"]["credits"]) <?php
$ch = curl_init("https://api.satelit.md/v1/geo/streets?q=Ismail");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]); {
"data": [
{
"name": "Strada Ismail",
"lat": 47.0201,
"lon": 28.8459,
"locality": {
"name": "Chișinău",
"kind": "city",
"raion": "chisinau"
}
}
],
"meta": {
"credits": 2,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "OpenStreetMap",
"url": "https://www.openstreetmap.org/copyright",
"license": "ODbL 1.0, © OpenStreetMap contributors",
"download": "https://api.satelit.md/downloads/places-osm.ndjson.gz"
}
],
"attribution": "Date: Satelit (satelit.md); © OpenStreetMap contributors, ODbL",
"page": {
"page": 1,
"per": 50,
"total": 1,
"pages": 1
}
}
}An address to a point
GET/v1/geo/search
An address as people write it ('str. Ismail 81/1, Chișinău', 'ул. Измаил, 81') to one point from OpenStreetMap, and how precise it is: `house` when the number stands on that street, `street` when only the street is known there, `locality` when only the town is. Never a guess: an address whose town cannot be read answers `data: null`. Costs 1 credit.
Parametri
-
qstringobligatoriuCuvinte de căutat.
-
citystringopționalOrașul.
Erori posibile
curl "https://api.satelit.md/v1/geo/search?q=mun.%20Chi%C8%99in%C4%83u%2C%20str.%20Ismail%2081%2F1" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/geo/search?q=mun.%20Chi%C8%99in%C4%83u%2C%20str.%20Ismail%2081%2F1", {
headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits); import json, os, urllib.request
req = urllib.request.Request(
"https://api.satelit.md/v1/geo/search?q=mun.%20Chi%C8%99in%C4%83u%2C%20str.%20Ismail%2081%2F1",
headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
body = json.load(res)
print(body["data"], body["meta"]["credits"]) <?php
$ch = curl_init("https://api.satelit.md/v1/geo/search?q=mun.%20Chi%C8%99in%C4%83u%2C%20str.%20Ismail%2081%2F1");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]); {
"data": {
"lat": 47.0201,
"lon": 28.8459,
"precision": "house",
"locality": "Chișinău",
"street": "Strada Ismail"
},
"meta": {
"credits": 1,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "OpenStreetMap",
"url": "https://www.openstreetmap.org/copyright",
"license": "ODbL 1.0, © OpenStreetMap contributors",
"download": "https://api.satelit.md/downloads/places-osm.ndjson.gz"
}
],
"attribution": "Date: Satelit (satelit.md); © OpenStreetMap contributors, ODbL"
}
}