mapnests-browser-sdk 1.1.1 → 1.1.2

package/README.md

@@ -35,7 +35,8 @@ A secure and efficient TS SDK for the **Mapnests Platform**, enabling powerful g
     -   [Search By Radius](#search-by-radius)
     -   [Multi Stop Point](#multi-stop-point)
     -   [Geocode Search](#geocode-search)
-    -   [Detailed Search By PlaceId ](#detailed-search-by-placeId)
+    -   [Detailed Search By PlaceId](#detailed-search-by-placeId)
+    -   [Snap to Road](#snap-to-road)
 
 -   [License](#license)
 -   [Contact](#contact)
@@ -706,6 +707,45 @@ console.log(detailsByPlaceId);
 ```
 <p align="right">(<a href="#readme-top">back to top</a>)</p>
 
+### Snap to Road
+
+<a name="snap-to-road"></a>
+
+> Returns the nearest road’s latitude and longitude for the given input coordinates.
+
+**Example Input:**
+
+```ts
+const snapToRoad = await client.snapToRoad({ 
+      mode: "walking",
+      latitude: 23.8103,
+      longitude: 90.4125
+    });
+console.log(snapToRoad);
+```
+
+**Example Output:**
+
+```json
+{
+  "data": {
+    "waypoints": [
+      {
+        "address": "Lane 11 East",
+        "location": [
+          90.412496,
+          23.810403
+        ],
+        "distance_meters": 11.41511481
+      }
+    ]
+  },
+  "message": "Success",
+  "status": true
+}
+```
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
 ---
 
 ## License

package/dist/build_url.js

@@ -17,7 +17,7 @@ function buildURLFromJSON(label, baseUrl, jsonStr) {
             const toLon = data.DestLon;
             const mode = encodeURIComponent(data.Mode);
             const path = label === 'distanceMatrixDetails' ? 'distancematrixdetails' : 'distancematrix';
-            const apiVersion = label === 'distanceMatrixDetails' ? 'v1' : 'v3';
+            const apiVersion = label === 'distanceMatrixDetails' ? 'v2' : 'v3';
             return `${baseUrl}/routemap/api/${apiVersion}/routes/${path}?fromLat=${fromLat}&fromLong=${fromLon}&toLat=${toLat}&toLong=${toLon}&mode=${mode}`;
         }
         case 'pairwiseRouteSummary': {
@@ -66,6 +66,9 @@ function buildURLFromJSON(label, baseUrl, jsonStr) {
             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}`;
         }
+        case 'snapToRoad': {
+            return `${exports.BASE_URL}/routemap/api/v1/nearest/road`;
+        }
         default:
             throw new Error(`unsupported label: ${label}`);
     }

package/dist/client.d.ts

@@ -10,6 +10,7 @@ import { ReverseRequest, ReverseResponse } from "./modules/reverse";
 import { SearchRequest, SearchResponse } from "./modules/search";
 import { SearchBboxRequest } from "./modules/search_bbox";
 import { SearchByRadiusRequest, SearchByRadiusResponse } from "./modules/search_by_radius";
+import { SnapToRoadRequest, SnapToRoadResponse } from "./modules/snap_to_road";
 export interface IClient {
     distanceMatrix(request: DistanceMatrixRequest): Promise<DistanceMatrixResponse>;
     pairwiseRouteSummary(request: PairwiseRouteSummaryRequest): Promise<PairwiseRouteSummaryResponse>;
@@ -22,6 +23,7 @@ export interface IClient {
     multiStopPoint(request: MultiStopPointsRequest): Promise<MultiStopPointsResponse>;
     autocomplete(request: AutocompleteRequest): Promise<AutocompleteResponse>;
     searchByRadius(request: SearchByRadiusRequest): Promise<SearchByRadiusResponse>;
+    snapToRoad(request: SnapToRoadRequest): Promise<SnapToRoadResponse>;
     searchWithBbox(request: SearchBboxRequest): Promise<string>;
 }
 export declare class Client implements IClient {
@@ -42,4 +44,5 @@ export declare class Client implements IClient {
     geocode(request: GeocodeRequest): Promise<GeocodeResponse>;
     multiStopPoint(request: MultiStopPointsRequest): Promise<MultiStopPointsResponse>;
     details(request: DetailsRequest): Promise<DetailsResponse>;
+    snapToRoad(request: SnapToRoadRequest): Promise<SnapToRoadResponse>;
 }

package/dist/client.js

@@ -99,5 +99,12 @@ class Client {
         console.log("📍 Details Search by Place ID response:", response);
         return response;
     }
+    async snapToRoad(request) {
+        console.log("📍 Snap to Road request:", request);
+        const response = await this.makeRequest("snapToRoad", request);
+        console.log("📍 Snap to Road response:");
+        console.dir(response, { depth: null, colors: true });
+        return response;
+    }
 }
 exports.Client = Client;

package/dist/main.js

@@ -136,6 +136,9 @@ const index_1 = require("./index");
         // ✅ 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));
+        // ✅ Snap to Road Example
+        const snapToRoadRes = await cl.snapToRoad({ mode: "walking", latitude: 23.8103, longitude: 90.4125 });
+        console.log("============================> Snap to Road:", JSON.stringify(snapToRoadRes, null, 2));
     }
     catch (err) {
         console.error("🔥 Error:", err);

package/dist/modules/snap_to_road.d.ts

@@ -0,0 +1,13 @@
+import { PlaceDetail } from "./details_by_place_id";
+import { Mode } from "./distance_matrix";
+export interface SnapToRoadRequest {
+    mode: Mode;
+    latitude: number;
+    longitude: number;
+    numberOfNearestRoad?: number;
+}
+export interface SnapToRoadResponse {
+    data: PlaceDetail[];
+    message: string;
+    status: boolean;
+}

package/dist/modules/snap_to_road.js

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

package/dist/secure_request.js

@@ -16,6 +16,7 @@ const HTTP_METHOD_MAP = {
     detailsByPlaceId: 'GET',
     autocomplete: 'GET',
     searchByRadius: 'GET',
+    snapToRoad: 'POST',
 };
 async function executeFetch(url, method, headers, body, timeoutMs) {
     const response = await fetch(url, {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mapnests-browser-sdk",
   "description": "TypeScript SDK for Mapnests API integration (Distance Matrix, Distance Matrix Details, Pairwise Route Summary, Multi Source Route Summary, Search, Reverse, Autocomplete, Autocomplete Without Zone, Multi Stop Points, Details By Place ID, Search By Radius, Geocode)",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {