Request Method: GET/POST Format: application/x-www-form-urlencoded
string keyword: Suggest keyword
CSV area: Geocode of suggest area (Default: Any area)
int offset: Offset of the first result returned (Default: 0)
int limit: Number of results returned (Default: 10)
CSV dataset: Suggest dataset (Default: Default data)
string key: Longdo Map API Key
string callback: JSONP Callback function (Default: Response in JSON)

Response Format: JSON
Object meta: Metadata

• string keyword: Request keyword

Object[] data: List of results

• string w: Suggest
• string d: Suggest with keyword highlighted
• string s: Dataset

Example

• Minimum params
• With area and limit

Request Method: GET/POST Format: application/x-www-form-urlencoded
string keyword: Search keyword
CSV area: Geocode of search area (Default: Any area)
number lon: Longitude of the center of result (Default: Silom)
number lat: Latitude of the center of result (Default: Silom)
string span: Span with unit in deg, m or km (Default: Anywhere)
CSV tag: Tag (Default: Any tag)
int offset: Offset of the first result returned (Default: 0)
int limit: Number of results returned (Default: 20)
CSV dataset: Search dataset (Default: Default data)
LocaleCode locale: Language in ISO 639-1 format (Default: th)
string key: Longdo Map API Key
string callback: JSONP Callback function (Default: Response in JSON)

Response Format: JSON
Object meta: Metadata

• boolean hasmore: Has more result
• int start: Start index
• int end: End index
• string keyword: Request keyword
• number lon: Location of search parameter if specified
• number lat: Location of search parameter if specified

Object[] data: List of results

• string type: Type of result
• string id: Longdo Map ID
• string name: Name
• number lat: Latitude
• number lon: Longitude
• string icon: Icon image
• string[] tag: List of tags
• string url: Website
• string address: Street address
• string tel: Telephone number
• string contributor: Last contributor
• bool verified: Is POI verified
• bool obsoleted: Is POI obsoleted
• string distance: Distance from center in the same unit of span, if span is provided

Example

• Minimum params
• With area and limit

Request Method: GET/POST Format: application/x-www-form-urlencoded
Accept all parameters of Search API with these additions

ForceSmartSearchFlag forcesmartsearch: Flag to indicate whether to perform SmartSearch function (Default: Only when there are few results)
int forcelimit: Minimum numbers of result from the Search that will not trigger next step of SmartSearch unless the 'forcesmartsearch' is set to 1 (Default: 1)
ExtendedSearchFlag extendedsearch: Perform extended search functions from external services (extra fee might apply) (Default: No extended search)
int extendedlimit: If the 'extendedsearch' is set to 1, this parameter is a minimum of longdo smart search results before using extended search (Default: 3)
string extendedkey: Extended API Key
ExtendedType extendedtype: Extended search type (Default: findplacefromtext)
number exceedtime: Limit time. If exceed, do only raw search. 0 = not use exceed time (Default: 0)
number cache: If equal to 1, enable cache (Default: 0)
bit extractaddress: If set to 1, response an extracted address object (Default: 0)

Response Format: JSON
Same as Search API with an additional value in each 'data' items

• string source: Map data source of search result, e.g., longdo, OSM

Example

• Search address

Request Method: GET/POST Format: application/x-www-form-urlencoded
string text: Address text for extract location
bit correction: If set to 1, enable text correction mode (Default: 1)
bit censor: If set to 1, telephone and email will be removed from response remark (Default: 0)

Response Format: JSON
Object meta: Metadata

• string input: Text input
• string remark: Remaining text after address extraction
• LocaleCode locale: Language in ISO 639-1 format

Object[] data: List of results

• string house_no: House number
• string floor: Floor
• string room: Room number
• string moo: Village number
• AddressInfo place: Place
• AddressInfo building: Building
• AddressInfo condominium: Condominium
• AddressInfo village: Gated community
• AddressInfo village_official: Village
• AddressInfo sublane: Narrow alley
• AddressInfo alley: Alley
• AddressInfo road: Road
• AddressInfo subdistrict: Subdistrict
• AddressInfo district: District
• AddressInfo province: Province
• string postcode: Postcode
• string country: Country
• number confidence: Score

AddressInfo
string name: Address info name (eg. place name, building name, condominium name etc.)
int distance: String similarity distance (0 = input text are all the same as correction data.)
boolean prefix: Do the text input have prefix?

Example

• Minimum params
• No correction
• Censor

Request Method: GET/POST Format: application/x-www-form-urlencoded
string text: Address text for search location
string dataset: Additional dataset

Response Format: JSON
Object[] data: List of results

• number confidence: Score
• Object location:
• LookupInfo point: Building
• string houseno: House number
• LookupInfo road: Road
• LookupInfo village: Village name
• string moo: Village number
• LookupInfo subdistrict: Subdistrict (tambon, khwaeng)
• LookupInfo district: District (amphoe, khet)
• LookupInfo province: Province
• string zipcode: Zipcode
• Location[] point: Possible location

string meta: Text input

LookupInfo
string name: Part name
int distance: String similarity distance
boolean prefix: Do the text input have prefix?

Example

• Minimum params

Request Method: GET/POST Format: application/x-www-form-urlencoded
string id: Search with Longdo Map ID (Optional)
number lon: Search with longitude if id isn't provide (Optional)
number lat: Search with latitude if id isn't provide (Optional)
LocaleCode locale: Language in ISO 639-1 format (Default: th)
any noadmin: Don't include geocode/province/district/subdistrict in the response (Default: Include)
any nopostcode: Don't include postcode in the response (Default: Include)
any noelevation: Don't include elevation in the response (Default: Include)
any noroad: Don't include road in the response (Default: Include)
any noaoi: Don't include area of interest in the response (Default: Include)
any nowater: Don't include water body in the response (Default: Include)
string key: Longdo Map API Key
string callback: JSONP Callback function (Default: Response in JSON)

Response Format: JSON
string geocode: Thailand geocode or ISO 3116-1 alpha-2 / ISO 3166-2
string country: Country
string province: Province or first-level administrative division
string district: District or second-level administrative division
string subdistrict: Subdistrict or third-level administrative division
string moo: Village number, if avaliable
string moo_name: Village name, if avaliable
string house_num: House number, if avaliable
string postcode: Thailand postcode
string aoi: Area of interest, if avaliable
string water: Water body, if exist
number elevation: Elevation in meters, if avaliable
string road: Road name, if exist
number road_lon: Nearest position on road
number road_lat: Nearest position on road

On Error
string error: Error message

Example

• With id
• With lat/lon, road only

Request Method: GET/POST Format: application/x-www-form-urlencoded
number[] lon: Search with longitude, up to 100 coordinates (Optional)
number[] lat: Search with latitude, up to 100 coordinates (Optional)
string wkt: Search with well-known text if lon/lat isn't provide, show only admin in the response (Optional)
LocaleCode locale: Language in ISO 639-1 format (Default: th)
any noadmin: Don't include geocode/province/district/subdistrict in the response
any nopostcode: Don't include postcode in the response
any noelevation: Don't include elevation in the response
any noroad: Don't include road in the response
any noaoi: Don't include area of interest in the response
any nowater: Don't include water body in the response
string key: Longdo Map API Key
string callback: JSONP Callback function (Default: Response in JSON)

Response Format: JSON
Object[] List of results in Reverse geocoding API format

On Error
string error: Error message

Example

• Search 2 locations without elevation
• Search with WKT

Request Method: GET/POST Format: application/x-www-form-urlencoded
string geocode: Search with geocode (Optional)
string postcode: Search with postcode if geocode isn't provide (Optional)
LocaleCode locale: Language in ISO 639-1 format (Default: th)
string key: Longdo Map API Key
string callback: JSONP Callback function (Default: Response in JSON)

Response Format: JSON
With geocode
string geocode: Geocode
string province: Province
string district: District
string subdistrict: Subdistrict
number lat: Latitude
number lon: Longitude

With postcode
Object[] address: List of areas in this postcode, in 'With geocode' part format

On Error
null : Error occurred

Example

• With geocode
• With postcode, Result in English

Request Method: GET/POST Format: application/x-www-form-urlencoded
CSV area: Geocode of search area (Default: Any area)
number lon: Longitude of the center of result (Default: Silom)
number lat: Latitude of the center of result (Default: Silom)
string span: Span with unit in deg, m or km (Default: Anywhere)
CSV tag: Tag (Default: Any tag)
int zoom: Importantness level of POI (Default: Any)
int offset: Offset of the first result returned (Default: 0)
int limit: Number of results returned (Default: 20)
CSV dataset: POI dataset (Default: Default data)
LocaleCode locale: Language in ISO 639-1 format (Default: th)
string key: Longdo Map API Key
string callback: JSONP Callback function (Default: Response in JSON)

Response Format: JSON
Same as Search API

Example

• Minimum params
• With tag, area and limit

Request Method: GET/POST Format: application/x-www-form-urlencoded
number flon: Longitude of the starting point
number flat: Latitude of the starting point
number tlon: Longitude of the destination
number tlat: Latitude of the destination
RouteMode mode: Search mode (Default: Avoid traffic)
RouteType type: Allow travel method (Default: All type)
LocaleCode locale: Language in ISO 639-1 format (Default: th)
RouteRestrict restrict: Vehicle restriction (Default: none)
Unix time time: Departure time, use with avoid traffic mode (Default: now, Past time is invalid)
int maxresult: Number of results (Default: 1, Max: 8)
string key: Longdo Map API Key
string callback: JSONP Callback function (Default: Response in JSON)

Response Format: JSON
Object meta: Metadata

• Location from: Starting point
• Location to: Destination
• string config: Request parameters

Object[] data: List of results

• number fdistance: Distance from starting point to nearest road in meters
• number tdistance: Distance from nearest road to destination in meters
• int distance: Distance in meters
• int interval: Travel time in seconds
• int id: Path ID for Get route path API
• Object[] guide: List of roads
• TurnCode turn: Turn instruction
• string name: Road name
• int distance: Section distance in meters
• int interval: Section travel time in seconds

On Error
Object meta : Metadata

• int status: 400: Bad request, 403: Origin is in closed area, 404: Not found, 410: Invalid argument
• string message: Error message

Example

• Minimum params
• Avoid traffic mode, Use road/ferry/tollway, Result in Thai

Request Method: GET/POST Format: application/x-www-form-urlencoded
int id: Path ID from Calculate route API

Response Format: JSON
Object meta: Metadata

• int id: Request path ID

Object[] data: List of results, same index as Calculate route API

• Location[] data: Road line

On Error
Same as Calculate route API, return only 404

Example

• Example (replace ID with recent one from Calculate route API)

Request Method: GET/POST Format: application/x-www-form-urlencoded
Accept all parameters of Calculate route API

Response Format: GeoJSON
FeatureCollection FeatureCollection: List of roads

• Object meta: Metadata, same as Calculate route API meta object
• Object data: Routing data, same as Calculate route API data object exclude id, guide

Feature Feature: A road

• Object properties: Road properties, same as Calculate route API guide object

On Error
Same as Calculate route API

Example

• Minimum params
• Minimum distance mode, Use road/tollway, Result in Thai

Request Method: GET/POST Format: application/x-www-form-urlencoded
number[] flon: Longitude of each starting point, up to 25 coordinates
number[] flat: Latitude of each starting point, up to 25 coordinates
number[] tlon: Longitude of each destination, up to 25 coordinates
number[] tlat: Latitude of each destination, up to 25 coordinates
RouteMode mode: Search mode (Default: Avoid traffic)
RouteType type: Allow travel method (Default: All type)
LocaleCode locale: Language in ISO 639-1 format (Default: th)
RouteRestrict restrict: Vehicle restriction (Default: none)
Unix time time: Departure time, use with avoid traffic mode (Default: now, Past time is invalid)
string key: Longdo Map API Key
string callback: JSONP Callback function (Default: Response in JSON)

Response Format: JSON
Object meta: Metadata

• int fromCount: Number of starting points
• int toCount: Number of destinations

Object[][] data: 2D List of results for each starting points and destinations

• int interval: Travel time in seconds
• int distance: Distance in meters

On Error
Same as Calculate route API, return only 400

Example

• Minimum params 2x2 matrix

Request Method: GET/POST Format: application/x-www-form-urlencoded
string wkt: LineString Well-known text

Response Format: JSON
Location[] Snap points for each WKT coordinated

On Error
Same as Calculate route API, return only 400, 410

Example

• Example

Request Method: GET
Response Format: JSON
Object[] List of results

• string polygon: Polygon or LineString well-known text of a close area
• int[] time: Alternating value between first and last hour of week of each closing period

Request Method: GET/POST Format: application/x-www-form-urlencoded
string[] polygon: Well-known text of close areas
string[] time: CSV of alternating value between first and last hour of week of each closing period of each area (Default: Always close)

Response Format: JSON
bool result: Result

Example

• Close on sunday and Saturday

Request Method: GET/POST Format: application/x-www-form-urlencoded
number lon: Longitude
number lat: Latitude
number range: Search range in degree (Default: 0.001, Max: 0.001 ~100m)
LocaleCode locale: Language in ISO 639-1 format or - for multi-language (Default: th)
Unix time time: Set to get predicted data (Default: now, Past time is invalid)
string key: Longdo Map API Key
string callback: JSONP Callback function (Default: Response in JSON)

Response Format: JSON
string road: Road name
string dir: Direction related to road geometry (forward / reverse)
number speed: Speed in m/s
string source: Source of data (real-time / predicted)
number lon: Nearest position on road
number lat: Nearest position on road
Object meta: Error code and message if no data found at the request location

On Error
Same as Calculate route API, return only 400 and 404

Example

• Minimum params
• No traffic data

Request Method: GET/POST Format: application/x-www-form-urlencoded
number flon: Longitude of the starting point
number flat: Latitude of the starting point
string span: Span with unit in m (meters, up to 30000m) or s (second, up to 1800s)
SpanFlag flag: Result type (Default: All)
string key: Longdo Map API Key
string callback: JSONP Callback function (Default: Response in JSON)

Response Format: JSON
Location from: Starting point
Location[][] lines: Road lines
Location[] polygon: Boundary of span

On Error
Same as Calculate route API, return only 400, 410

Example

• Minimum params
• Only boundary

Request Method: POST Format: application/x-www-form-urlencoded
number[] lon: Longitude list
number[] lat: Latitude list
boolean cost: Cost (Default: false )
    true : time_step and distance_step details will be included
    false : Only the optimal path without additional information will be returned
boolean otsp: Is Open Loop TSP (Default: false )
    true : Return to start/first point
    false : Do not return to start/first point
RouteMode mode: Search mode (Default: Avoid traffic)
string key: Longdo Map API Key

Response Format: JSON

Status
string status: HTTP status code indicating the success or failure of the request
string message: Description of the status

Request Configuration
boolean otsp: Indicating whether the route is an Open Loop TSP (OTSP)
RouteMode mode: Route search mode, defaulting to 'c' (Avoid traffic)
Object body: Contains detailed information about the route

Route Details

• int[] sequence: Ordered list of indices representing the sequence in which locations should be visited. The sequence is circular, ending where it began
• Location[] location: Array of objects, each containing latitude (lat) and longitude (lon) of a specific location
• int total_distance: Total distance of the optimal route
• int total_time: Total time required to traverse the optimal route

Step-by-Step Information

• Object[] time_step: Array of objects providing time-related details for each route segment
• int start: Index of the starting location in the sequence
• int end: Index of the ending location in the sequence
• int cost: Time required to travel from the start to the end
• Object[] distance_step: Array of objects providing distance-related details for each route segment
• int start: Index of the starting location in the sequence
• int end: Index of the ending location in the sequence
• int cost: Distance between the start and end locations

On Error
Return only status and message

Example

• Minimum params
• Blog

Request Method: GET/POST Format: application/x-www-form-urlencoded
GeoJSON polygon: Area

Response Format: JSON
int ms_building: Number of buildings

On Error
string error: Error message

Example

• Minimum params