@maptiler/sdk 2.4.2 → 2.5.1

package/dist/src/MaptilerGeolocateControl.d.ts

@@ -18,4 +18,5 @@ export declare class MaptilerGeolocateControl extends GeolocateControl {
     _finishSetupUI: (supported: boolean) => void;
     _updateCircleRadius(): void;
     _onZoom: () => void;
+    _setErrorState(): void;
 }

package/dist/src/language.d.ts

@@ -1,80 +1,75 @@
 import { LanguageInfo } from '@maptiler/client';
 
 declare const Language: {
-    readonly AUTO: LanguageInfo;
-    readonly LATIN: LanguageInfo;
-    readonly NON_LATIN: LanguageInfo;
-    readonly LOCAL: LanguageInfo;
+    readonly ALBANIAN: LanguageInfo;
     readonly AMHARIC: LanguageInfo;
     readonly ARABIC: LanguageInfo;
+    readonly ARMENIAN: LanguageInfo;
     readonly AZERBAIJANI: LanguageInfo;
+    readonly BASQUE: LanguageInfo;
     readonly BELARUSIAN: LanguageInfo;
-    readonly BULGARIAN: LanguageInfo;
     readonly BENGALI: LanguageInfo;
-    readonly BRETON: LanguageInfo;
     readonly BOSNIAN: LanguageInfo;
+    readonly BRETON: LanguageInfo;
+    readonly BULGARIAN: LanguageInfo;
     readonly CATALAN: LanguageInfo;
     readonly CHINESE: LanguageInfo;
     readonly TRADITIONAL_CHINESE: LanguageInfo;
     readonly SIMPLIFIED_CHINESE: LanguageInfo;
     readonly CORSICAN: LanguageInfo;
+    readonly CROATIAN: LanguageInfo;
     readonly CZECH: LanguageInfo;
-    readonly WELSH: LanguageInfo;
     readonly DANISH: LanguageInfo;
+    readonly DUTCH: LanguageInfo;
     readonly GERMAN: LanguageInfo;
     readonly GREEK: LanguageInfo;
     readonly ENGLISH: LanguageInfo;
     readonly ESPERANTO: LanguageInfo;
-    readonly SPANISH: LanguageInfo;
     readonly ESTONIAN: LanguageInfo;
-    readonly BASQUE: LanguageInfo;
     readonly FINNISH: LanguageInfo;
     readonly FRENCH: LanguageInfo;
     readonly FRISIAN: LanguageInfo;
-    readonly IRISH: LanguageInfo;
-    readonly SCOTTISH_GAELIC: LanguageInfo;
+    readonly GEORGIAN: LanguageInfo;
     readonly HEBREW: LanguageInfo;
     readonly HINDI: LanguageInfo;
-    readonly CROATIAN: LanguageInfo;
     readonly HUNGARIAN: LanguageInfo;
-    readonly ARMENIAN: LanguageInfo;
-    readonly INDONESIAN: LanguageInfo;
     readonly ICELANDIC: LanguageInfo;
+    readonly INDONESIAN: LanguageInfo;
+    readonly IRISH: LanguageInfo;
     readonly ITALIAN: LanguageInfo;
     readonly JAPANESE: LanguageInfo;
     readonly JAPANESE_HIRAGANA: LanguageInfo;
     readonly JAPANESE_2018: LanguageInfo;
     readonly JAPANESE_KANA: LanguageInfo;
     readonly JAPANESE_LATIN: LanguageInfo;
-    readonly GEORGIAN: LanguageInfo;
-    readonly KAZAKH: LanguageInfo;
     readonly KANNADA: LanguageInfo;
+    readonly KAZAKH: LanguageInfo;
     readonly KOREAN: LanguageInfo;
     readonly KOREAN_LATIN: LanguageInfo;
     readonly KURDISH: LanguageInfo;
     readonly CLASSICAL_LATIN: LanguageInfo;
-    readonly LUXEMBOURGISH: LanguageInfo;
-    readonly LITHUANIAN: LanguageInfo;
     readonly LATVIAN: LanguageInfo;
+    readonly LITHUANIAN: LanguageInfo;
+    readonly LUXEMBOURGISH: LanguageInfo;
     readonly MACEDONIAN: LanguageInfo;
     readonly MALAYALAM: LanguageInfo;
     readonly MALTESE: LanguageInfo;
-    readonly DUTCH: LanguageInfo;
     readonly NORWEGIAN: LanguageInfo;
     readonly OCCITAN: LanguageInfo;
-    readonly POLISH: LanguageInfo;
     readonly PERSIAN: LanguageInfo;
+    readonly POLISH: LanguageInfo;
+    readonly PORTUGUESE: LanguageInfo;
     readonly PUNJABI: LanguageInfo;
     readonly WESTERN_PUNJABI: LanguageInfo;
-    readonly PORTUGUESE: LanguageInfo;
-    readonly ROMANSH: LanguageInfo;
     readonly ROMANIAN: LanguageInfo;
+    readonly ROMANSH: LanguageInfo;
     readonly RUSSIAN: LanguageInfo;
-    readonly SLOVAK: LanguageInfo;
-    readonly SLOVENE: LanguageInfo;
-    readonly ALBANIAN: LanguageInfo;
     readonly SERBIAN_CYRILLIC: LanguageInfo;
     readonly SERBIAN_LATIN: LanguageInfo;
+    readonly SCOTTISH_GAELIC: LanguageInfo;
+    readonly SLOVAK: LanguageInfo;
+    readonly SLOVENE: LanguageInfo;
+    readonly SPANISH: LanguageInfo;
     readonly SWEDISH: LanguageInfo;
     readonly TAMIL: LanguageInfo;
     readonly TELUGU: LanguageInfo;
@@ -82,6 +77,11 @@ declare const Language: {
     readonly TURKISH: LanguageInfo;
     readonly UKRAINIAN: LanguageInfo;
     readonly VIETNAMESE: LanguageInfo;
+    readonly WELSH: LanguageInfo;
+    readonly AUTO: LanguageInfo;
+    readonly LATIN: LanguageInfo;
+    readonly NON_LATIN: LanguageInfo;
+    readonly LOCAL: LanguageInfo;
     /**
      * Language mode to display labels in both the local language and the language of the visitor's device, concatenated.
      * Note that if those two languages are the same, labels won't be duplicated.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maptiler/sdk",
-  "version": "2.4.2",
+  "version": "2.5.1",
   "description": "The Javascript & TypeScript map SDK tailored for MapTiler Cloud",
   "module": "dist/maptiler-sdk.mjs",
   "types": "dist/maptiler-sdk.d.ts",
@@ -62,7 +62,7 @@
   },
   "dependencies": {
     "@maplibre/maplibre-gl-style-spec": "^20.3.1",
-    "@maptiler/client": "^2.0.0",
+    "@maptiler/client": "^2.2.0",
     "events": "^3.3.0",
     "js-base64": "^3.7.4",
     "maplibre-gl": "4.7.1",

package/readme.md

@@ -987,7 +987,40 @@ Turning off *zoom compensation* allows for more accurate adjustments to the visu
 
 All the other options are documented on [our reference page](https://docs.maptiler.com/sdk-js/api/helpers/#heatmap) and more examples are available [here](https://docs.maptiler.com/sdk-js/examples/?q=heatmap+helper).
 
-# Other helper
+# Other helpers
+## Convert GPX and KML to GeoJSON
+In the [Polyline helper section](#polyline-layer-helper) above, we have seen that one can feed the helper directly with a path to a GPX or KML file, that is then converted under the hood client-side into a GeoJSON `FeatureCollection` object. This conversion feature is also exposed and can be used as such:
+
+```ts
+import { gpx } from "@maptiler/sdk";
+
+// ... assuming inside an async function
+
+// Fetching the GPX file as a string:
+const gpxFilePath = "some_gps_trace.gpx";
+const gpxResponse = await fetch(gpxFilePath);
+const gpxStr = await res.text();
+
+// Converting the GPX payload into a GeoJSON FeatureCollection:
+const features = maptilersdk.gpx(gpxStr);
+```
+
+And for KML files:
+```ts
+import { kml } from "@maptiler/sdk";
+
+// ... assuming inside an async function
+
+// Fetching the KML file as a string:
+const kmlFilePath = "some_gps_trace.kml";
+const kmlResponse = await fetch(kmlFilePath);
+const kmlStr = await res.text();
+
+// Converting the KML payload into a GeoJSON FeatureCollection:
+const features = maptilersdk.gpx(kmlStr);
+```
+
+
 ## Take Screenshots, programmatically
 There are two different ways to create screenshot, corresponding to two very different usecases. Note that screenshots will not contain *DOM elements* such as `Marker` and `Popup`, since those are not part of the rendering context.