شروع سریع

curl -G https://api.uttamap.ir/v1/search \
  -H "X-Api-Key: um_sk_..." \
  --data-urlencode "q=میدان آزادی" \
  --data-urlencode "city=تهران"

{
  "results": [
    {
      "label": "میدان آزادی، تهران",
      "location": { "lat": 35.6997, "lng": 51.3375 },
      "type": "square",
      "components": { "province": "استان تهران", "city": "تهران" },
      "precision": "landmark",
      "id": "osm:r7790807"
    }
  ]
}

<link href="https://cdn.jsdelivr.net/npm/maplibre-gl@5/dist/maplibre-gl.css" rel="stylesheet">
<script src="https://cdn.jsdelivr.net/npm/maplibre-gl@5/dist/maplibre-gl.js"></script>
<div id="map" style="height:420px"></div>
<script>
  maplibregl.setRTLTextPlugin("https://tiles.uttamap.ir/js/rtl-text.js", true);
  const map = new maplibregl.Map({
    container: "map",
    style: "https://tiles.uttamap.ir/styles/light/style.json?key=um_pk_...",
    center: [51.389, 35.689], // [lng, lat]
    zoom: 11,
  });
</script>