@nextgis/geocoder 1.18.12 → 1.18.17

package/lib/index.d.ts

@@ -9,6 +9,7 @@ import CancelablePromise from '@nextgis/cancelable-promise';
 import type { FeatureItem } from '@nextgis/ngw-connector';
 import type { FetchNgwItemsOptions } from '@nextgis/ngw-kit';
 import { GeoJsonObject } from 'geojson';
+import { LngLatArray } from '@nextgis/utils';
 import { LngLatBoundsArray } from '@nextgis/utils';
 import NgwConnector from '@nextgis/ngw-connector';
 import type { NgwConnectorOptions } from '@nextgis/ngw-connector';
@@ -38,6 +39,15 @@ declare abstract class BaseGeocoder<O extends Record<string, any> = Record<strin
      * @returns {CancelablePromise<any>} - A promise that resolves to the detailed result.
      */
     abstract result(item: SearchItem): CancelablePromise<any>;
+    /**
+     * Method for reverse geocoding.
+     * Takes coordinates and returns the corresponding address or location information.
+     *
+     * @abstract
+     * @param {LngLatArray} coordinates - The longitude and latitude values.
+     * @returns {AsyncGenerator<SearchItem>} - An async generator that yields reverse geocoding results.
+     */
+    abstract reverse(coordinates: LngLatArray): AsyncGenerator<SearchItem>;
     /**
      * Optional method to abort any ongoing geocoding requests.
      *
@@ -88,6 +98,14 @@ export declare class Geocoder extends BaseGeocoder<GeocoderOptions> {
     abort(): void;
     search(query: string): AsyncGenerator<SearchItem, void, unknown>;
     result(item: SearchItem): CancelablePromise<any>;
+    reverse(coordinates: LngLatArray): AsyncGenerator<SearchItem, void, unknown>;
+    /**
+     * Returns the first reverse geocoding result for given coordinates from any provider.
+     *
+     * @param {LngLatArray} coordinates - The longitude and latitude values.
+     * @returns {Promise<SearchItem | undefined>} - A promise that resolves to the first reverse geocoding result, or undefined if no results are found.
+     */
+    reverseGeocodeFirstResult(coordinates: LngLatArray): Promise<SearchItem | undefined>;
 }
 
 /**
@@ -109,6 +127,7 @@ export declare class NgwProvider extends BaseProvider<NgwProviderOptions> {
     abort(): void;
     search(query: string): AsyncGenerator<NgwSearchItem, void, unknown>;
     result(item: NgwSearchItem): CancelablePromise<ResultItem>;
+    reverse(coordinates: LngLatArray): AsyncGenerator<SearchItem, void, unknown>;
     private _makeSignal;
     private _items;
 }
@@ -146,6 +165,7 @@ export declare class NominatimProvider extends BaseProvider {
     abort(): void;
     search(val: string): AsyncGenerator<SearchItem, void, unknown>;
     result(model: SearchItem): CancelablePromise<ResultItem>;
+    reverse(coordinates: LngLatArray): AsyncGenerator<SearchItem, void, unknown>;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextgis/geocoder",
-  "version": "1.18.12",
+  "version": "1.18.17",
   "description": "",
   "main": "index.js",
   "module": "lib/geocoder.esm-bundler.js",
@@ -10,7 +10,7 @@
   "dependencies": {
     "@nextgis/cancelable-promise": "^1.18.3",
     "@nextgis/ngw-connector": "^1.18.12",
-    "@nextgis/ngw-kit": "^1.18.12",
+    "@nextgis/ngw-kit": "^1.18.15",
     "@nextgis/utils": "^1.18.12",
     "@types/events": "^3.0.0",
     "@types/geojson": "^7946.0.8",
@@ -53,5 +53,5 @@
   "bugs": {
     "url": "https://github.com/nextgis/nextgis_frontend/issues"
   },
-  "gitHead": "ab0530144ecdb94222fdac520fad5b98d302ec6d"
+  "gitHead": "c35f8efdb73787faa15861cd664ef83ebddb09c0"
 }