Магазини та місця

GET/v1/places

Рядки з OpenStreetMap, з фільтрами й пошуком навколо точки. Коштує 2 кредити за 100 рядків.

Кредити: 2 за кожні 100 рядків
: З ключем

Параметри

kindstring: shop, venueнеобов'язковий

shop або venue.
citystringнеобов'язковий

Місто.
chainstringнеобов'язковий

Мережа магазинів.
categorystringнеобов'язковий

Ключ категорії, з /v1/news/categories.
nearstringнеобов'язковий

Точка: lat,lon.
radiusintegerнеобов'язковийза замовчуванням 2000

Радіус у метрах, щонайбільше 20000.
pageintegerнеобов'язковийза замовчуванням 1

Сторінка, починаючи з 1.

Можливі помилки

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"]);

Відповідь

{
  "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
    }
  }
}