@aapicoits/powermap-web-sdk 1.1.0 → 1.1.1

package/README.md

@@ -695,22 +695,60 @@ const map = new PowerMap({
 
 ## 12. 🔍 Search & Geocoding
 
-The Web SDK provides built-in search capabilities using the PowerMap Search API.
+The Web SDK provides built-in search capabilities using the PowerMap Search API with automatic script detection, smart field fallbacks, and cross-endpoint query handling.
 
 ### `search(query, options)`
 
 Available options:
 
-- `lang`: `'th'` (default) or `'en'`.
-- `location`: `[latitude, longitude]` to prioritize nearby results.
+| Option | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `lang` | `string` | `'auto'` | Language mode: `'auto'`, `'th'`, or `'en'`. In `'auto'` mode, script type is detected automatically from Unicode ranges. |
+| `location` | `[lat, lng]` | `-` | `[latitude, longitude]` coordinate pair to prioritize nearby search results. |
+
+#### Automatic Script Detection & Fallbacks
+- **`lang: 'auto'`**: Automatically inspects query characters. Thai queries (`[\u0E00-\u0E7F]`) select Thai search services, while English/Latin queries (`[a-zA-Z]`) select English search services.
+- **Mixed Script Handling**: For mixed search terms (e.g. `"Central บางนา"` or `"BTS อโศก"`), if primary search yields no results or contains mixed scripts, the SDK automatically executes a cross-endpoint fallback search and merges unique results.
+- **Smart Field Mapping**: `name` and `address` automatically default to the preferred query language with automatic fallback (`nameEn` -> `nameTh` -> `name` or `nameTh` -> `nameEn` -> `name`), ensuring titles and addresses are never returned as empty strings.
+
+#### Returned `SearchResult` Properties
+
+Each item in the returned array contains:
+
+| Field | Type | Description |
+| :--- | :--- | :--- |
+| `id` / `gid` | `string` | Unique identifier for the POI. |
+| `name` | `string` | Display name in the preferred language with automatic fallback. |
+| `nameEn` | `string` | English name of the place (with Thai fallback). |
+| `nameTh` | `string` | Thai name of the place (with English fallback). |
+| `address` | `string` | Formatted address in the preferred language with fallback. |
+| `addressEn` | `string` | Formatted English address string. |
+| `addressTh` | `string` | Formatted Thai address string. |
+| `position` | `[lat, lng]` | Coordinate pair `[latitude, longitude]` (compatible with Mobile SDK). |
+| `positionLngLat` | `[lng, lat]` | Coordinate pair `[longitude, latitude]` for Web map view manipulation. |
+| `province` / `amphoe` / `tambon` | `string` | Administrative boundary details. |
+| `postCode` | `string` | Postal code if available. |
+| `rawData` | `Object` | Raw Elasticsearch GeoJSON source payload. |
+
+### Search Examples
 
 ```javascript
-const results = await map.search("Central World", { lang: 'en' });
+// 1. Auto language detection (Recommended)
+const results = await map.search("Central World");
 
 results.forEach(item => {
-  console.log(`${item.name}: ${item.address}`);
-  console.log(`Position: ${item.position}`); // [lat, lng]
+  console.log(`${item.name} (${item.nameTh}): ${item.address}`);
+  console.log(`Position [lat, lng]:`, item.position);
 });
+
+// 2. Explicit English search with location prioritization
+const enResults = await map.search("Siam Paragon", {
+  lang: 'en',
+  location: [13.746, 100.534] // [lat, lng]
+});
+
+// 3. Mixed query (Thai + English)
+const mixedResults = await map.search("BTS อโศก", { lang: 'auto' });
 ```
 
 ---

package/dist/index.d.ts

@@ -88,16 +88,27 @@ export interface RouteSummary {
 }
 
 export interface SearchResult {
-  id: string;
+  id?: string;
+  gid?: string;
   name: string;
+  nameEn?: string;
+  nameTh?: string;
   address?: string;
+  addressEn?: string;
+  addressTh?: string;
   position: [number, number];
+  positionLngLat?: [number, number];
+  province?: string;
+  amphoe?: string;
+  tambon?: string;
+  postCode?: string;
+  rawData?: Record<string, unknown>;
   [key: string]: unknown;
 }
 
 export interface SearchOptions {
   location?: [number, number];
-  lang?: string;
+  lang?: 'th' | 'en' | 'auto' | string;
   [key: string]: unknown;
 }