Added adjustUrl function (#71)

* added `adjustUrl` function

* added `adjustUrl` example

* updated documentations

examples/maplibregl/AppMapLibreGl.svelte

@@ -31,6 +31,13 @@
         { type: "client-geolocation", minZoom: 8 },
         { type: "server-geolocation", minZoom: 8 },
       ],
+      adjustUrl(url) {
+        // for reverse geocoding use only address type
+        if (/\/\d+\.?\d*%2C\d+.?\d*.json$/.test(url.pathname)) {
+          url.searchParams.set("types", "address");
+          url.searchParams.set("limit", "5");
+        }
+      },
       marker(map, feature) {
         if (!feature) {
           return;

src/GeocodingControl.svelte

@@ -128,8 +128,16 @@
     import.meta.env.VITE_LIB_VERSION +
     "/icons/";
 
+  /**
+   * @deprecated use `adjustUrl`
+   */
   export let adjustUrlQuery: (sp: URLSearchParams) => void = () => {};
 
+  /**
+   * Adjust geocoding URL before the fetch.
+   */
+  export let adjustUrl: (url: URL) => void = () => {};
+
   /**
    * Focus the search input box.
    *
@@ -458,7 +466,18 @@
     try {
       const isReverse = isQueryReverse(searchValue);
 
-      const sp = new URLSearchParams();
+      const urlObj = new URL(
+        apiUrl +
+          "/" +
+          encodeURIComponent(
+            isReverse
+              ? isReverse.decimalLongitude + "," + isReverse.decimalLatitude
+              : searchValue,
+          ) +
+          ".json",
+      );
+
+      const sp = urlObj.searchParams;
 
       if (language !== undefined) {
         sp.set(
@@ -508,16 +527,9 @@
 
       adjustUrlQuery(sp);
 
-      const url =
-        apiUrl +
-        "/" +
-        encodeURIComponent(
-          isReverse
-            ? isReverse.decimalLongitude + "," + isReverse.decimalLatitude
-            : searchValue,
-        ) +
-        ".json?" +
-        sp.toString();
+      adjustUrl(urlObj);
+
+      const url = urlObj.toString();
 
       if (url === lastSearchUrl) {
         if (byId) {

src/react.ts

@@ -36,6 +36,7 @@ type MapControllerProp = {
 
 const propertyNames = [
   "adjustUrlQuery",
+  "adjustUrl",
   "apiKey",
   "bbox",
   "clearButtonTitle",

src/types.ts

@@ -309,9 +309,20 @@ export type ControlOptions = {
    * Function to adjust URL search parameters.
    *
    * Default value is empty function.
+   *
+   * @deprecated use `adjustUrl`
    */
   adjustUrlQuery?: (sp: URLSearchParams) => void;
 
+  /**
+   * Function to adjust geocoding URL before the fetch.
+   *
+   * @param url [URL](https://developer.mozilla.org/en-US/docs/Web/API/URL) parameter which can be modified
+   *
+   * Default value is empty function.
+   */
+  adjustUrl?: (url: URL) => void;
+
   /**
    * Automatically select the first feature from the result list.
    *