Magazine și locuri

GET/v1/places

Rânduri din OpenStreetMap, cu filtre și căutare în jurul unui punct. Costă 2 credite pe 100 de rânduri.

Credite: 2 pentru fiecare 100 rânduri
: Cu cheie

Parametri

kindstring: shop, venueopțional

shop sau venue.
citystringopțional

Orașul.
chainstringopțional

Rețeaua de magazine.
categorystringopțional

Cheia categoriei, din /v1/news/categories.
nearstringopțional

Un punct: lat,lon.
radiusintegeropționalimplicit 2000

Raza în metri, cel mult 20000.
pageintegeropționalimplicit 1

Pagina, de la 1.

Erori posibile

curl "https://api.satelit.md/v1/places?kind=shop&near=47.0225%2C28.8353&radius=1000" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/places?kind=shop&near=47.0225%2C28.8353&radius=1000", {
  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/places?kind=shop&near=47.0225%2C28.8353&radius=1000",
    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/places?kind=shop&near=47.0225%2C28.8353&radius=1000");
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"]);

Răspuns

{
  "data": [
    {
      "id": "n293219605",
      "kind": "shop",
      "name": "Nr 1",
      "chain": null,
      "category": "supermarket",
      "address": "Bulevardul Ștefan cel Mare și Sfânt 132",
      "lat": 47.02257,
      "lon": 28.83587,
      "city": "Chișinău",
      "phone": null,
      "website": null,
      "opening_hours": null,
      "updated_at": "2026-10-31"
    }
  ],
  "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": 100,
      "total": 7651,
      "pages": 77
    }
  }
}