mapnests-browser-sdk 1.0.7 → 1.0.8

package/README.md

@@ -29,8 +29,14 @@ A secure and efficient TS SDK for the **Mapnests Platform**, enabling powerful g
     -   [Pairwise Route Summary](#pairwise-route-summary)
     -   [Multi Source Route Summary](#multi-source-route-summary)
     -   [Distance Matrix Details](#distance-matrix-details)
-    -   [Search (Geocoding)](#search-geocoding)
-    -   [Reverse Geocoding](#reverse-geocoding)
+    -   [Search](#search)
+    -   [Reverse](#reverse)
+    -   [Autocomplete](#autocomplete)
+    -   [Autocomplete Without Zone](#autocomplete-without-zone)
+    -   [Search By Radius](#search-by-radius)
+    -   [Multi Stop Point](#multi-stop-point)
+    -   [Detailed Geolocation Information ](#detailed-geolocation-information)
+    -   [Geocode Search](#geocode-search)
 
 -   [License](#license)
 -   [Contact](#contact)
@@ -63,6 +69,9 @@ import { Client, Mode } from "mapnests-browser-sdk"";
 (async function () {
     const client = new Client("YOUR_API_KEY", "your.package.name");
 
+    // With optional timeout (in milliseconds)
+    const clientWithTimeout = new Client("YOUR_API_KEY", "your.package.name", 30000); // 30 seconds
+
     const result = await client.search({ Query: "Dhaka" });
     console.log("Search result:", result);
 })();
@@ -289,9 +298,9 @@ console.log(details);
 
 <p align="right">(<a href="#readme-top">back to top</a>)</p>
 
-### Search (Geocoding)
+### Search
 
-> Finds places, streets, and landmarks by text query.
+> Finds places, streets, and landmarks using text-based queries. The search can also be refined by providing latitude and longitude with radius support.
 
 **Example Input:**
 
@@ -301,29 +310,61 @@ const searchRes = await client.search({
 });
 console.log(searchRes);
 ```
+*To get only Zone Data provide ActiveLocations*
+
+```ts
+const searchRes = await client.search({
+    Query: "Bashundhara Residential Area, Dhaka",
+    ActiveLocations: true
+});
+console.log(searchRes);
+```
+
 
 **Example Output:**
 
 ```json
 {
-    "data": [
-        {
-            "place_id": "123456",
-            "lat": "23.8156",
-            "lon": "90.4287",
-            "display_name": "Bashundhara Residential Area, Dhaka, Bangladesh"
-        }
+  "data": {
+    "items": [
+      {
+        "placeId": "61aa7fe80c299c0a67966c8f2fbc9093626e38093c62cea2dc07b561f30f9d8c",
+        "lat": 23.8074008,
+        "lon": 90.3682003,
+        "types": [ "amenity", "bus_station", "amenity" ],
+        "address": "Bangladesh",
+        "name": "Mirpur-10",
+        "houseNumber": "",
+        "houseName": "",
+        "street": "",
+        "phone": "",
+        "website": "",
+        "country": "Bangladesh",
+        "city": "",
+        "thana": "",
+        "division": "",
+        "district": "",
+        "postalCode": "1216",
+        "plusCode": "",
+        "sublocality": "",
+        "localArea": ""
+      }
     ],
-    "status": true,
-    "message": "success"
+    "itemsPerPage": 1,
+    "pageNumber": 1,
+    "totalItems": 27,
+    "totalPages": 27
+  },
+  "message": "Success",
+  "status": true
 }
 ```
 
 <p align="right">(<a href="#readme-top">back to top</a>)</p>
 
-### Reverse Geocoding
+### Reverse
 
-> Converts GPS coordinates into a readable address.
+> Reverse geocodes coordinates to return detailed location information for a given latitude and longitude.
 
 **Example Input:**
 
@@ -336,16 +377,340 @@ console.log(revRes);
 
 ```json
 {
-    "data": {
-        "displayName": "Farmgate, Tejgaon, Dhaka, Bangladesh",
-        "address": {
-            "country": "Bangladesh",
-            "state": "Dhaka Division",
-            "city": "Dhaka"
-        }
+  "data": {
+    "placeId": "a4d8c105e24fbc3d91bb0486e1701fa20b9b56329df0fc5c47f7df003e3cc579",
+    "lat": 23.7952951,
+    "lon": 90.41680379038863,
+    "category": "",
+    "type": "yes",
+    "class": "building",
+    "name": "Concord Ik Tower",
+    "address": "Concord Ik Tower, House#2, Road 94, Gulshan North Avenue, Gulshan 2, Gulshan, Dhaka-1212",
+    "country": "Bangladesh",
+    "city": "Gulshan 2, Dhaka",
+    "thana": "Gulshan",
+    "district": "Dhaka",
+    "division": "",
+    "postalCode": "1212",
+    "website": "",
+    "houseNumber": "2",
+    "houseName": "",
+    "subLocality": "",
+    "localArea": "",
+    "types": [
+      "building",
+      "yes",
+      "building"
+    ]
+  },
+  "message": "Success",
+  "status": true
+}
+
+```
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+### Autocomplete
+
+> Auto Complete suggests relevant places, streets, and landmarks as you type a partial search query.
+
+**Example Input:**
+
+```ts
+const autoCompleteRes = await client.autocomplete({ Query: "Gulshan Road"});
+console.log(autoCompleteRes);
+```
+
+**Example Output:**
+
+```json
+{
+  "data": [
+    {
+      "placeId": "4e7820118661ce107f308dff7648bf0a9d2847b78b720b08c9d39fe3662c4a8c",
+      "name": "Gulshan",
+      "address": "Gulshan, House#76, Palolika, Road-24, Gulshan-1, Gulshan, Dhaka-1212",
+      "types": [
+        "landuse",
+        "residential",
+        "landuse"
+      ]
+    }
+  ],
+  "message": "Success",
+  "status": true
+}
+
+```
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+### Autocomplete Without Zone
+
+> Auto Complete suggests relevant places, streets, and landmarks as you type a partial search query.
+
+**Example Input:**
+
+```ts
+const autocompleteResWithoutZone = await client.autocompleteWithoutZone({ Query: "Uttara"});
+console.log( JSON.stringify(autocompleteResWithoutZone,));
+```
+
+**Example Output:**
+
+```json
+{
+  "data": [
+    {
+      "placeId": "7d7e8fd275bfd9be9853ada14417d104e824d1c11600599bd326fb858429d83c",
+      "name": "Uttara",
+      "address": "Uttara, House#21, Road 17, Sector 11, Uttara, Dhaka-1230",
+      "types": [
+        "amenity",
+        "restaurant",
+        "amenity"
+      ]
+    }
+}
+```
+
+### Search By Radius
+
+> Finds places, streets, and landmarks using text-based queries. All searches are restricted to results within the specified radius, which requires latitude, longitude, and radius parameters.
+
+**Example Input:**
+
+```ts
+const searchByRadiusRes = await cl.searchByRadius({ 
+        Query: "uttara", Lat: 23.7272064, Lon: 90.3861125, Radius: 5000
+    });
+console.log(searchByRadiusRes);
+```
+
+**Example Output:**
+
+```json
+{
+  "data": {
+    "items": [
+      {
+        "placeId": "f6e5bf556e2163d89f65d634b6456d28736a6a72dc1c1df933a8b13d0597956a",
+        "lat": 23.714221,
+        "lon": 90.4059638,
+        "types": [ "amenity", "bank", "amenity" ],
+        "address": "Uttara Bank",
+        "name": "Uttara Bank",
+        "houseNumber": "",
+        "houseName": "",
+        "street": "Nawab Yousuf Sarak",
+        "phone": "",
+        "website": "",
+        "country": "Bangladesh",
+        "city": "",
+        "thana": "",
+        "division": "",
+        "district": "",
+        "postalCode": "1100",
+        "plusCode": "",
+        "sublocality": "",
+        "localArea": ""
+      }
+    ],
+    "itemsPerPage": 1,
+    "pageNumber": 1,
+    "totalItems": 12,
+    "totalPages": 12
+  },
+  "message": "Success",
+  "status": true
+}
+
+```
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+### Multi Stop Point
+
+> Calculates distance, ETA, and route geometry for a journey starting from a single source and passing through multiple stop points in sequence. It returns both total and per-segment results, processes routes concurrently for efficiency, and supports multiple stops.
+
+**Example Input:**
+
+```ts
+  const multiStopRes = await client.multiStopPoint({
+            Src: { lat: 23.8103, lon: 90.4125 },
+            StopPoints: [
+                { id: 1, lat: 23.8113, lon: 90.4135 },
+                { id: 2, lat: 23.8123, lon: 90.4145 },
+                { id: 3, lat: 23.8133, lon: 90.4155 },
+            ],
+            Mode: Mode.Car,
+        });
+```
+
+**Example Output:**
+
+```json
+ {
+  "data": {
+    "distanceInMeters": 1357.7999725341797,
+    "etaInSeconds": 252.10000228881836,
+    "routeSummaries": [
+      {
+        "id": 1,
+        "source": {
+          "lat": 23.8103,
+          "lon": 90.4125
+        },
+        "stopPoint": {
+          "lat": 23.8113,
+          "lon": 90.4135
+        },
+        "distanceInMeters": 213.3,
+        "etaInSeconds": 47.3,
+        "geometry": "_nipCcuyfPCkB}DJCgB"
+      },
+      {
+        "id": 2,
+        "source": {
+          "lat": 23.8113,
+          "lon": 90.4135
+        },
+        "stopPoint": {
+          "lat": 23.8123,
+          "lon": 90.4145
+        },
+        "distanceInMeters": 191.4,
+        "etaInSeconds": 44.5,
+        "geometry": "etipCk{yfPEaDQc@}CD"
+      },
+      {
+        "id": 3,
+        "source": {
+          "lat": 23.8123,
+          "lon": 90.4145
+        },
+        "stopPoint": {
+          "lat": 23.8133,
+          "lon": 90.4155
+        },
+        "distanceInMeters": 953.1,
+        "etaInSeconds": 160.3,
+        "geometry": "{yipCkazfPmBDG}CqO`@UKYo@CWT_E`FS@p@jAPpDMBbC"
+      }
+    ]
+  },
+  "message": "Success",
+  "status": true
+}
+```
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+### Detailed Geolocation Information
+
+> Provide detailed geolocation information for a place using its unique place_id, including address, coordinates, administrative regions, contact details, and metadata.
+
+**Example Input:**
+
+```ts
+const detailsRes = await client.details({ PlaceId: "a97641e310481507f5bfdbeed6f0e946358b252bb3f82103ed7f5e59b04d422e" });
+```
+
+**Example Output:**
+
+```json
+{
+  "data": {
+    "placeId": "a97641e310481507f5bfdbeed6f0e946358b252bb3f82103ed7f5e59b04d422e",
+    "lat": 23.8696386,
+    "lon": 90.3995743,
+    "types": [
+      "shop",
+      "travel_agency",
+      "shop"
+    ],
+    "address": "Uttara",
+    "name": "Nogor Travel Agency",
+    "houseNumber": "9",
+    "houseName": "",
+    "street": "Road 7",
+    "phone": "",
+    "website": "",
+    "country": "Bangladesh",
+    "city": "Uttara, Dhaka",
+    "thana": "Uttara West",
+    "division": "",
+    "district": "Dhaka",
+    "postalCode": "1230",
+    "plusCode": "",
+    "sublocality": "",
+    "localArea": ""
+  },
+  "message": "Success",
+  "status": true
+}
+```
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+### Geocode Search
+
+> Search for details about places, streets, and landmarks using a text query.
+
+**Example Input:**
+
+```ts
+const geocodeRes = await client.geocode({ Query: "Mirpur" });
+```
+
+**Example Output:**
+
+```json
+{
+  "data": [
+    {
+      "place_id": 373373,
+      "lat": "23.9363038",
+      "lon": "88.997764",
+      "category": "boundary",
+      "type": "administrative",
+      "place_rank": 12,
+      "importance": 0.24000999999999997,
+      "addresstype": "town",
+      "name": "Mirpur",
+      "display_name": "Mirpur, Kushtia District, Khulna Division, Bangladesh",
+      "address": ""
     },
-    "status": true,
-    "message": "success"
+    {
+      "place_id": 399534,
+      "lat": "23.1460109",
+      "lon": "90.7556272",
+      "category": "place",
+      "type": "village",
+      "place_rank": 19,
+      "importance": 0.14667666666666662,
+      "addresstype": "village",
+      "name": "Mirpur",
+      "display_name": "Mirpur, Faridganj Upazila, Chandpur District, Chattogram Division, Bangladesh",
+      "address": ""
+    },
+    {
+      "place_id": 479355,
+      "lat": "23.817758949999998",
+      "lon": "90.37244789599441",
+      "category": "place",
+      "type": "suburb",
+      "place_rank": 19,
+      "importance": 0.14667666666666662,
+      "addresstype": "suburb",
+      "name": "Mirpur",
+      "display_name": "Mirpur, Dhaka, Dhaka Metropolitan, Dhaka District, Dhaka Division, 1216, Bangladesh",
+      "address": ""
+    }
+  ],
+  "message": "Success",
+  "status": true
 }
 ```
 

package/dist/build_url.js

@@ -7,7 +7,7 @@ function buildURLFromJSON(label, baseUrl, jsonStr) {
     const data = JSON.parse(jsonStr);
     switch (label) {
         case 'reverse': {
-            return `${baseUrl}/geomap/api/v1/reverse?lat=${data.Lat}&lon=${data.Lon}`;
+            return `${baseUrl}/geomap/api/v2/reverse?lat=${data.Lat}&lon=${data.Lon}`;
         }
         case 'distanceMatrix':
         case 'distanceMatrixDetails': {
@@ -17,7 +17,8 @@ function buildURLFromJSON(label, baseUrl, jsonStr) {
             const toLon = data.DestLon;
             const mode = encodeURIComponent(data.Mode);
             const path = label === 'distanceMatrixDetails' ? 'distancematrixdetails' : 'distancematrix';
-            return `${baseUrl}/routemap/api/v1/routes/${path}?fromLat=${fromLat}&fromLong=${fromLon}&toLat=${toLat}&toLong=${toLon}&mode=${mode}`;
+            const apiVersion = label === 'distanceMatrixDetails' ? 'v1' : 'v3';
+            return `${baseUrl}/routemap/api/${apiVersion}/routes/${path}?fromLat=${fromLat}&fromLong=${fromLon}&toLat=${toLat}&toLong=${toLon}&mode=${mode}`;
         }
         case 'pairwiseRouteSummary': {
             return `${baseUrl}/routemap/api/v1/routes/pairwise-summary`;
@@ -27,7 +28,49 @@ function buildURLFromJSON(label, baseUrl, jsonStr) {
         }
         case 'search': {
             const query = encodeURIComponent(data.Query);
-            return `${baseUrl}/geomap/api/v1/search?q=${query}`;
+            const lat = data.Lat ? `&lat=${data.Lat}` : '';
+            const lon = data.Lon ? `&lon=${data.Lon}` : '';
+            const radius = data.Radius ? `&radius=${data.Radius}` : '';
+            const activeLocations = !!data.ActiveLocations;
+            const limit = data.Limit ? `&limit=${data.Limit}` : '';
+            const page = data.Page ? `&page=${data.Page}` : '';
+            return `${baseUrl}/geomap/api/v2/search?q=${query}&activeLocations=${activeLocations}${limit}${lat}${lon}${radius}${page}`;
+        }
+        case 'detailsByPlaceId': {
+            const placeId = encodeURIComponent(data.PlaceId);
+            return `${baseUrl}/geomap/api/v1/details/${placeId}`;
+        }
+        case 'geocode': {
+            const query = encodeURIComponent(data.Query);
+            const limit = data.Limit ? `&limit=${data.Limit}` : '';
+            return `${baseUrl}/geomap/api/v2/geocode?q=${query}${limit}`;
+        }
+        case 'multiStopPoints': {
+            return `${baseUrl}/routemap/api/v1/routes/multi-stoppoints`;
+        }
+        case 'autocomplete': {
+            const query = encodeURIComponent(data.Query);
+            const limit = data.Limit ? `&limit=${data.Limit}` : '';
+            const lat = data.Lat ? `&lat=${data.Lat}` : '';
+            const lon = data.Lon ? `&lon=${data.Lon}` : '';
+            return `${baseUrl}/geomap/api/v1/autocomplete?q=${query}${limit}${lat}${lon}`;
+        }
+        case 'autocompleteWithoutZone': {
+            const query = encodeURIComponent(data.Query);
+            const limit = data.Limit ? `&limit=${data.Limit}` : '';
+            const lat = data.Lat ? `&lat=${data.Lat}` : '';
+            const lon = data.Lon ? `&lon=${data.Lon}` : '';
+            return `${baseUrl}/geomap/api/v1/autocomplete/all?q=${query}${limit}${lat}${lon}`;
+        }
+        case 'searchByRadius': {
+            const query = encodeURIComponent(data.Query);
+            const lat = data.Lat;
+            const lon = data.Lon;
+            const radius = data.Radius;
+            const activeLocations = !!data.ActiveLocations;
+            const limit = data.Limit ? `&limit=${data.Limit}` : '';
+            const page = data.Page ? `&page=${data.Page}` : '';
+            return `${baseUrl}/geomap/api/v2/search/radius?q=${query}&lat=${lat}&lon=${lon}&radius=${radius}&activeLocations=${activeLocations}${limit}${page}`;
         }
         default:
             throw new Error(`unsupported label: ${label}`);

package/dist/client.d.ts

@@ -1,9 +1,15 @@
-import { SearchRequest, SearchResponse } from "./modules/search";
-import { ReverseRequest, ReverseResponse } from "./modules/reverse";
+import { AutocompleteRequest, AutocompleteResponse } from "./modules/autocomplete";
+import { DetailsRequest, DetailsResponse } from "./modules/details_by_place_id";
 import { DistanceMatrixRequest, DistanceMatrixResponse } from "./modules/distance_matrix";
-import { PairwiseRouteSummaryRequest, PairwiseRouteSummaryResponse } from "./modules/pairwise_route_summary";
 import { DistanceMatrixDetailsRequest, DistanceMatrixDetailsResponse } from "./modules/distance_matrix_details";
+import { GeocodeRequest, GeocodeResponse } from "./modules/geocode";
 import { MultiSourceRouteSummaryRequest, MultiSourceRouteSummaryResponse } from "./modules/multi_source_route_summary";
+import { MultiStopPointsRequest, MultiStopPointsResponse } from "./modules/multi_stop_points";
+import { PairwiseRouteSummaryRequest, PairwiseRouteSummaryResponse } from "./modules/pairwise_route_summary";
+import { ReverseRequest, ReverseResponse } from "./modules/reverse";
+import { SearchRequest, SearchResponse } from "./modules/search";
+import { SearchByRadiusRequest, SearchByRadiusResponse } from "./modules/search_by_radius";
+import { SearchBboxRequest } from "./modules/search_bbox";
 export interface IClient {
     distanceMatrix(request: DistanceMatrixRequest): Promise<DistanceMatrixResponse>;
     pairwiseRouteSummary(request: PairwiseRouteSummaryRequest): Promise<PairwiseRouteSummaryResponse>;
@@ -11,16 +17,31 @@ export interface IClient {
     distanceMatrixDetails(request: DistanceMatrixDetailsRequest): Promise<DistanceMatrixDetailsResponse>;
     reverse(request: ReverseRequest): Promise<ReverseResponse>;
     search(request: SearchRequest): Promise<SearchResponse>;
+    details(request: DetailsRequest): Promise<DetailsResponse>;
+    geocode(request: GeocodeRequest): Promise<GeocodeResponse>;
+    multiStopPoint(request: MultiStopPointsRequest): Promise<MultiStopPointsResponse>;
+    autocomplete(request: AutocompleteRequest): Promise<AutocompleteResponse>;
+    autocompleteWithoutZone(request: AutocompleteRequest): Promise<AutocompleteResponse>;
+    searchByRadius(request: SearchByRadiusRequest): Promise<SearchByRadiusResponse>;
+    searchWithBbox(request: SearchBboxRequest): Promise<string>;
 }
 export declare class Client implements IClient {
     private apiKey;
     private packageName;
-    constructor(apiKey: string, packageName: string);
+    private timeOutMs?;
+    constructor(apiKey: string, packageName: string, timeOutMs?: number | undefined);
     private makeRequest;
     distanceMatrix(request: DistanceMatrixRequest): Promise<DistanceMatrixResponse>;
     pairwiseRouteSummary(request: PairwiseRouteSummaryRequest): Promise<PairwiseRouteSummaryResponse>;
     multiSourceRouteSummary(request: MultiSourceRouteSummaryRequest): Promise<MultiSourceRouteSummaryResponse>;
     distanceMatrixDetails(request: DistanceMatrixDetailsRequest): Promise<DistanceMatrixDetailsResponse>;
     reverse(request: ReverseRequest): Promise<ReverseResponse>;
-    search(request: SearchRequest): Promise<SearchResponse>;
+    search(request: SearchRequest): Promise<any>;
+    autocomplete(request: AutocompleteRequest): Promise<AutocompleteResponse>;
+    autocompleteWithoutZone(request: AutocompleteRequest): Promise<AutocompleteResponse>;
+    searchWithBbox(request: SearchBboxRequest): Promise<string>;
+    searchByRadius(request: SearchByRadiusRequest): Promise<SearchByRadiusResponse>;
+    geocode(request: GeocodeRequest): Promise<GeocodeResponse>;
+    multiStopPoint(request: MultiStopPointsRequest): Promise<MultiStopPointsResponse>;
+    details(request: DetailsRequest): Promise<DetailsResponse>;
 }

package/dist/client.js

@@ -2,13 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Client = void 0;
 const secure_req_1 = require("./secure_req");
+const validate_query_length_1 = require("./validate_query_length");
+const underMaintenanceMessage = "This method is currently under maintenance. Please try again later.";
 class Client {
-    constructor(apiKey, packageName) {
+    constructor(apiKey, packageName, timeOutMs) {
         this.apiKey = apiKey;
         this.packageName = packageName;
+        this.timeOutMs = timeOutMs;
     }
     async makeRequest(label, request) {
-        const { statusCode, response, errorMessage } = await (0, secure_req_1.callSecureRequest)(label, this.apiKey, this.packageName, request);
+        const { statusCode, response, errorMessage } = await (0, secure_req_1.callSecureRequest)(label, this.apiKey, this.packageName, request, this.timeOutMs);
         if (errorMessage) {
             throw new Error(`[${label}] native error: ${errorMessage}`);
         }
@@ -45,8 +48,60 @@ class Client {
     }
     async search(request) {
         console.log("📍 Search request:", request);
+        (0, validate_query_length_1.validateQueryLength)(request.Query);
         const response = await this.makeRequest("search", request);
-        console.log("📍 Search response:", response);
+        console.log("📍 Search response:");
+        console.dir(response, { depth: null, colors: true });
+        return response;
+    }
+    async autocomplete(request) {
+        console.log("📍 Autocomplete request:", request);
+        (0, validate_query_length_1.validateQueryLength)(request.Query);
+        const response = await this.makeRequest("autocomplete", request);
+        console.log("📍 Autocomplete response:");
+        console.dir(response, { depth: null, colors: true });
+        return response;
+    }
+    async autocompleteWithoutZone(request) {
+        console.log("📍 Autocomplete Without Zone request:", request);
+        (0, validate_query_length_1.validateQueryLength)(request.Query);
+        const response = await this.makeRequest("autocompleteWithoutZone", request);
+        console.log("📍 Autocomplete Without Zone response:");
+        console.dir(response, { depth: null, colors: true });
+        return response;
+    }
+    //Under Maintenance
+    async searchWithBbox(request) {
+        console.log("📍 Search Bbox request:", request);
+        // validateQueryLength(request.Query);
+        console.log("📍 Search Bbox response:", underMaintenanceMessage);
+        return underMaintenanceMessage;
+    }
+    // Under Maintenance
+    async searchByRadius(request) {
+        (0, validate_query_length_1.validateQueryLength)(request.Query);
+        console.log("📍 Search by Radius request:", request);
+        const response = await this.makeRequest("searchByRadius", request);
+        console.log("📍 Search By Radius response:");
+        console.dir(response, { depth: null, colors: true });
+        return response;
+    }
+    async geocode(request) {
+        console.log("📍 Geocode search request", request);
+        const response = await this.makeRequest("geocode", request);
+        console.log("📍 Geocode response:", response);
+        return response;
+    }
+    async multiStopPoint(request) {
+        console.log("📍 Multi stop point search request", request);
+        const response = await this.makeRequest("multiStopPoints", request);
+        console.log("📍 Multi stop point response:", response);
+        return response;
+    }
+    async details(request) {
+        console.log("📍 Details Search by Place ID request:", request);
+        const response = await this.makeRequest("detailsByPlaceId", request);
+        console.log("📍 Details Search by Place ID response:", response);
         return response;
     }
 }

package/dist/index.d.ts

@@ -1,9 +1,14 @@
+export * from "./fetch_remote_time";
+export * from "./modules/autocomplete";
+export * from "./modules/details_by_place_id";
 export * from "./modules/distance_matrix";
-export * from "./modules/pairwise_route_summary";
 export * from "./modules/distance_matrix_details";
-export * from "./modules/reverse";
-export * from "./modules/search";
+export * from "./modules/geocode";
 export * from "./modules/multi_source_route_summary";
+export * from "./modules/multi_stop_points";
 export * from "./modules/pairwise_route_summary";
-export * from "./fetch_remote_time";
+export * from "./modules/reverse";
+export * from "./modules/search";
+export * from "./modules/search_by_radius";
+export * from "./modules/search_bbox";
 export { Client } from "./client";

package/dist/index.js

@@ -15,13 +15,18 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Client = void 0;
+__exportStar(require("./fetch_remote_time"), exports);
+__exportStar(require("./modules/autocomplete"), exports);
+__exportStar(require("./modules/details_by_place_id"), exports);
 __exportStar(require("./modules/distance_matrix"), exports);
-__exportStar(require("./modules/pairwise_route_summary"), exports);
 __exportStar(require("./modules/distance_matrix_details"), exports);
-__exportStar(require("./modules/reverse"), exports);
-__exportStar(require("./modules/search"), exports);
+__exportStar(require("./modules/geocode"), exports);
 __exportStar(require("./modules/multi_source_route_summary"), exports);
+__exportStar(require("./modules/multi_stop_points"), exports);
 __exportStar(require("./modules/pairwise_route_summary"), exports);
-__exportStar(require("./fetch_remote_time"), exports);
+__exportStar(require("./modules/reverse"), exports);
+__exportStar(require("./modules/search"), exports);
+__exportStar(require("./modules/search_by_radius"), exports);
+__exportStar(require("./modules/search_bbox"), exports);
 var client_1 = require("./client");
 Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return client_1.Client; } });

package/dist/main.js

@@ -4,6 +4,7 @@ const index_1 = require("./index");
 (async function () {
     try {
         const cl = new index_1.Client("", "");
+        // ✅ DistanceMatrixRequest Example
         const res = await cl.distanceMatrix({
             OriginLat: 23.8103,
             OriginLon: 90.4125,
@@ -12,6 +13,7 @@ const index_1 = require("./index");
             Mode: index_1.Mode.Walking,
         });
         console.log("============================> DistanceMatrix:", res);
+        // ✅ DistanceMatrixDetailsRequest Example
         const deRes = await cl.distanceMatrixDetails({
             OriginLat: 23.8103,
             OriginLon: 90.4125,
@@ -20,13 +22,15 @@ const index_1 = require("./index");
             Mode: index_1.Mode.Walking,
         });
         console.log("============================> DistanceMatrixDetails:", deRes);
-        const searchRes = await cl.search({ Query: "uttara" });
-        console.log("============================> Search:", searchRes);
+        // ✅ SearchRequest Example
+        const searchRes = await cl.search({ Query: "mirpur 10", ActiveLocations: true, Limit: 1 });
+        console.log("============================> Search:", JSON.stringify(searchRes, null, 2));
+        // ✅ ReverseRequest Example
         const revRes = await cl.reverse({
-            Lat: 23.8103,
-            Lon: 90.4125,
+            Lat: 23.795295,
+            Lon: 90.416803,
         });
-        console.log("============================> Reverse Geocode:", revRes);
+        console.log("============================> Reverse Geocode:", JSON.stringify(revRes, null, 2));
         // ✅ PairwiseRouteSummaryRequest Example
         const pairwiseRes = await cl.pairwiseRouteSummary({
             pairs: [
@@ -109,6 +113,33 @@ const index_1 = require("./index");
             },
         });
         console.log("============================> MultiSourceRouteSummary:", multiSourceRes);
+        // ✅ MultiStopPointRequest Example
+        const multiStopRes = await cl.multiStopPoint({
+            Src: { lat: 23.8103, lon: 90.4125 },
+            StopPoints: [
+                { id: 1, lat: 23.8113, lon: 90.4135 },
+                { id: 2, lat: 23.8123, lon: 90.4145 },
+                { id: 3, lat: 23.8133, lon: 90.4155 },
+            ],
+            Mode: index_1.Mode.Car,
+        });
+        console.log("============================> MultiStopPoint:", JSON.stringify(multiStopRes, null, 2));
+        // ✅ Details By PlaceId Example
+        const detailsRes = await cl.details({ PlaceId: "" });
+        console.log("============================> Details by Place ID:", detailsRes);
+        // ✅ AutocompleteRequest Example
+        const autoCompleteRes = await cl.autocomplete({ Query: "Gulshan Road", limit: 1 });
+        console.log("============================> Autocomplete:", JSON.stringify(autoCompleteRes, null, 2));
+        console.dir(autoCompleteRes, { depth: null, color: true });
+        // ✅ AutocompleteWithoutZoneRequest Example
+        const autocompleteResWithoutZone = await cl.autocompleteWithoutZone({ Query: "Uttara", limit: 2 });
+        console.log("============================> Autocomplete Without Zone:", JSON.stringify(autocompleteResWithoutZone, null, 2));
+        // ✅ SearchBboxRequest Example
+        const searchBboxRes = await cl.searchWithBbox({ Query: "uttara", TopLeftLat: 23.799012278864893, TopLeftLon: 90.43487817491183, BottomRightLat: 23.798243503885544, BottomRightLon: 90.43537003653393 });
+        console.log("============================> Search With Boundary box:", searchBboxRes);
+        // ✅ SearchByRadiusRequest Example
+        const searchByRadiusRes = await cl.searchByRadius({ Query: "uttara", Lat: 23.7272064, Lon: 90.3861125, Radius: 5000, Limit: 1 });
+        console.log("============================> Search By Radius:", JSON.stringify(searchByRadiusRes, null, 2));
     }
     catch (err) {
         console.error("🔥 Error:", err);

package/dist/modules/autocomplete.d.ts

@@ -0,0 +1,17 @@
+export interface AutocompleteRequest {
+    Query: string;
+    Lat?: number;
+    Lon?: number;
+    Limit?: number;
+}
+export interface AutocompleteResponse {
+    data: AutocompleteData[];
+    message: string;
+    status: boolean;
+}
+export interface AutocompleteData {
+    place_id: string;
+    name: string;
+    address: string;
+    types: string[];
+}

package/dist/modules/autocomplete.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/modules/details_by_place_id.d.ts

@@ -0,0 +1,30 @@
+export interface DetailsRequest {
+    PlaceId: string;
+}
+export interface PlaceDetail {
+    placeId: string;
+    lat: number;
+    lon: number;
+    types: string[];
+    address: string;
+    name: string;
+    houseNumber: string;
+    houseName: string;
+    street: string;
+    phone: string;
+    website: string;
+    country: string;
+    city: string;
+    thana: string;
+    division: string;
+    district: string;
+    postalCode: string;
+    plusCode: string;
+    sublocality: string;
+    localArea: string;
+}
+export interface DetailsResponse {
+    data: PlaceDetail;
+    message: string;
+    status: boolean;
+}

package/dist/modules/details_by_place_id.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/modules/geocode.d.ts

@@ -0,0 +1,21 @@
+export interface GeocodeRequest {
+    Query: string;
+    Limit?: number;
+}
+export interface PlaceItem {
+    place_id: number;
+    lat: string;
+    lon: string;
+    category: string;
+    type: string;
+    place_rank: number;
+    importance: number;
+    addresstype: string;
+    name: string;
+    display_name: string;
+}
+export interface GeocodeResponse {
+    data: PlaceItem[];
+    message: string;
+    status: boolean;
+}

package/dist/modules/geocode.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/modules/multi_stop_points.d.ts

@@ -0,0 +1,24 @@
+import { Mode } from "./distance_matrix";
+import { Coordinate, RouteSummary } from "./pairwise_route_summary";
+export interface MultiStopPointsRequest {
+    Src: Coordinate;
+    StopPoints: StopPoint[];
+    Mode: Mode;
+}
+export interface StopPoint extends Coordinate {
+    id: number;
+}
+export interface MultiStopPointsRouteSummary extends RouteSummary {
+    source: Coordinate;
+    stopPoint: Coordinate;
+}
+export interface MultiStopPointsRouteData {
+    distanceInMeters: number;
+    etaInSeconds: number;
+    routeSummaries: MultiStopPointsRouteSummary[];
+}
+export interface MultiStopPointsResponse {
+    data: MultiStopPointsRouteData;
+    message: string;
+    status: boolean;
+}

package/dist/modules/multi_stop_points.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/modules/reverse.d.ts

@@ -8,29 +8,24 @@ export interface ReverseResponse {
     status: boolean;
 }
 export interface ReverseData {
-    placeRank: number;
-    importance: number;
-    name: string;
-    addresstype: string;
-    lon: string;
-    lat: string;
+    placeId: string;
+    lat: number;
+    lon: number;
     category: string;
     type: string;
-    displayName: string;
-    placeid: number;
-    address: Address;
-}
-export interface Address {
+    class: string;
+    name: string;
+    address: string;
     country: string;
-    countryCode: string;
     city: string;
-    road: string;
-    stateDistrict: string;
-    iso31662Lvl4: string;
-    iso31662Lvl5: string;
-    municipality: string;
-    postcode: string;
-    suburb: string;
-    borough: string;
-    state: string;
+    thana: string;
+    district: string;
+    division: string;
+    postalCode: string;
+    website: string;
+    houseNumber: string;
+    houseName: string;
+    subLocality: string;
+    localArea: string;
+    types: string[];
 }

package/dist/modules/search.d.ts

@@ -1,16 +1,44 @@
 export interface SearchRequest {
     Query: string;
+    Lat?: number;
+    Lon?: number;
+    Radius?: number;
+    ActiveLocations?: boolean;
+    Page?: number;
+    Limit?: number;
+    AcceptLanguage?: string;
 }
 export interface SearchResponse {
-    data: SearchData[];
+    data: SearchData;
     message: string;
     status: boolean;
 }
 export interface SearchData {
-    place_id: string;
-    lat: string;
-    lon: string;
-    addresstypes: string[];
-    display_name: string;
-    display_address: string;
+    items: SearchItem[];
+    itemsPerPage: number;
+    pageNumber: number;
+    totalItems: number;
+    totalPages: number;
+}
+export interface SearchItem {
+    placeId: string;
+    lat: number;
+    lon: number;
+    types: string[];
+    address: string;
+    name: string;
+    houseNumber: string;
+    houseName: string;
+    street: string;
+    phone: string;
+    website: string;
+    country: string;
+    city: string;
+    thana: string;
+    division: string;
+    district: string;
+    postalCode: string;
+    plusCode: string;
+    sublocality: string;
+    localArea: string;
 }

package/dist/modules/search_bbox.d.ts

@@ -0,0 +1,10 @@
+export interface SearchBboxRequest {
+    Query: string;
+    TopLeftLat: number;
+    TopLeftLon: number;
+    BottomRightLat: number;
+    BottomRightLon: number;
+    Page?: number;
+    Limit?: number;
+    AcceptLanguage?: string;
+}

package/dist/modules/search_bbox.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/modules/search_by_radius.d.ts

@@ -0,0 +1,16 @@
+import { SearchData } from "./search";
+export interface SearchByRadiusRequest {
+    Query: string;
+    Lat: number;
+    Lon: number;
+    Radius: number;
+    AcceptLanguage?: string;
+    Page?: number;
+    Limit?: number;
+    ActiveLocations?: boolean;
+}
+export interface SearchByRadiusResponse {
+    data: SearchData;
+    message: string;
+    status: boolean;
+}

package/dist/modules/search_by_radius.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/request.d.ts

@@ -1,6 +1,7 @@
 export declare class Client {
     private apiKey;
     private packageName;
-    constructor(apiKey: string, packageName: string);
+    private timeOutMs?;
+    constructor(apiKey: string, packageName: string, timeOutMs?: number | undefined);
     request(label: string, request: object): Promise<Uint8Array>;
 }

package/dist/request.js

@@ -3,12 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Client = void 0;
 const secure_req_1 = require("./secure_req");
 class Client {
-    constructor(apiKey, packageName) {
+    constructor(apiKey, packageName, timeOutMs) {
         this.apiKey = apiKey;
         this.packageName = packageName;
+        this.timeOutMs = timeOutMs;
     }
     async request(label, request) {
-        const { statusCode, response, errorMessage } = await (0, secure_req_1.callSecureRequest)(label, this.apiKey, this.packageName, request);
+        const { statusCode, response, errorMessage } = await (0, secure_req_1.callSecureRequest)(label, this.apiKey, this.packageName, request, this.timeOutMs);
         if (errorMessage) {
             throw new Error(`[${label}] native error: ${errorMessage}`);
         }

package/dist/secure_req.d.ts

@@ -1,4 +1,4 @@
-export declare function callSecureRequest(label: string, apiKey: string, origin: string, request: object): Promise<{
+export declare function callSecureRequest(label: string, apiKey: string, origin: string, request: object, timeOutMs?: number): Promise<{
     statusCode: number;
     response: string;
     errorMessage?: string;

package/dist/secure_req.js

@@ -2,10 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.callSecureRequest = callSecureRequest;
 const secure_request_1 = require("./secure_request");
-async function callSecureRequest(label, apiKey, origin, request) {
+async function callSecureRequest(label, apiKey, origin, request, timeOutMs) {
     try {
         const jsonRequest = JSON.stringify(request);
-        const result = await (0, secure_request_1.performSecureRequest)(label, apiKey, origin, jsonRequest);
+        const result = await (0, secure_request_1.performSecureRequest)(label, apiKey, origin, jsonRequest, timeOutMs);
         if (!result.success) {
             return {
                 statusCode: result.statusCode,

package/dist/secure_request.d.ts

@@ -4,4 +4,4 @@ export interface SecureResult {
     response: string;
     errorMessage?: string;
 }
-export declare function performSecureRequest(label: string, apiKey: string, origin: string, jsonRequest: string): Promise<SecureResult>;
+export declare function performSecureRequest(label: string, apiKey: string, origin: string, jsonRequest: string, timeOutMs?: number): Promise<SecureResult>;

package/dist/secure_request.js

@@ -5,8 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.performSecureRequest = performSecureRequest;
 const axios_1 = __importDefault(require("axios"));
-const generate_token_1 = require("./generate_token");
 const build_url_1 = require("./build_url");
+const generate_token_1 = require("./generate_token");
 const BASE_URL = 'https://engine.mapnests.com';
 const HTTP_METHOD_MAP = {
     reverse: 'GET',
@@ -15,8 +15,14 @@ const HTTP_METHOD_MAP = {
     distanceMatrixDetails: 'GET',
     pairwiseRouteSummary: 'POST',
     multiSourceSummary: 'POST',
+    multiStopPoints: 'POST',
+    geocode: 'GET',
+    detailsByPlaceId: 'GET',
+    autocomplete: 'GET',
+    autocompleteWithoutZone: 'GET',
+    searchByRadius: 'GET',
 };
-async function performSecureRequest(label, apiKey, origin, jsonRequest) {
+async function performSecureRequest(label, apiKey, origin, jsonRequest, timeOutMs) {
     let urlStr;
     try {
         urlStr = (0, build_url_1.buildURLFromJSON)(label, BASE_URL, jsonRequest);
@@ -34,7 +40,7 @@ async function performSecureRequest(label, apiKey, origin, jsonRequest) {
     };
     const axiosConfig = {
         headers,
-        timeout: 30000,
+        timeout: timeOutMs || 30000,
     };
     try {
         const response = method === 'POST'

package/dist/validate_query_length.d.ts

@@ -0,0 +1 @@
+export declare const validateQueryLength: (query: string) => void;

package/dist/validate_query_length.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateQueryLength = void 0;
+const validateQueryLength = (query) => {
+    if (query.length < 3) {
+        throw new Error(`Please provide a query parameter with more than 2 characters.`);
+    }
+};
+exports.validateQueryLength = validateQueryLength;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mapnests-browser-sdk",
   "description": "TypeScript SDK for Mapnests API integration (Distance Matrix, Distance Matrix Details, Geocode, Reverse Geocode)",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -46,4 +46,4 @@
     "type": "git",
     "url": "git@vcs.technonext.com:mapnests/map-libraries/tn-map-js-library.git"
   }
-}
+}