mahal_map 1.6.13 → 1.6.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -12,6 +12,28 @@ npm install mahal_map maplibre-gl
12
12
 
13
13
  `maplibre-gl` является peer dependency. Его нужно установить в приложении или подключить отдельным browser script перед SDK.
14
14
 
15
+ Для нового 3D-движка (`engine: "3d"`) дополнительно нужен `@osm/maps3d-web`. Пакет **не публикуется в npm** — скачайте его со страницы платформы (кнопка «Web SDK — стартер»; в Vue-стартере это папка `libs/maps3d-web` с уже собранным `dist/`), положите в проект и поставьте как локальную зависимость:
16
+
17
+ ```sh
18
+ npm i ./libs/maps3d-web maplibre-gl
19
+ ```
20
+
21
+ `package.json` запишет ссылку на локальную папку:
22
+
23
+ ```json
24
+ "@osm/maps3d-web": "file:./libs/maps3d-web"
25
+ ```
26
+
27
+ Без сборщика возьмите `lib/maps3d.global.js` из скачанного стартера (IIFE-глобал `Maps3D`, three бандлится внутрь) и подключите скриптом после `maplibre-gl`:
28
+
29
+ ```html
30
+ <script src="https://cdn.jsdelivr.net/npm/maplibre-gl@4.7.1/dist/maplibre-gl.js"></script>
31
+ <script src="./lib/maps3d.global.js"></script>
32
+ <script src="https://cp.mahal.tj/sdk/mahal_map.sdk.js?apikey=YOUR_MAP_API_KEY"></script>
33
+ ```
34
+
35
+ SDK сам найдёт конструктор в `window.Maps3D.Maps3D` — передавать его вручную не нужно.
36
+
15
37
  ## Быстрый старт через NPM
16
38
 
17
39
  ```ts