Search (V2) | TrackAsia GL JS Docs

Searches for keywords and returns a list of relevant places.

Url

Method: GET

  https://sg-maps.track-asia.com/api/v2/geocode/outputFormat?parameters

Example

https://sg-maps.track-asia.com/api/v2/geocode/json?address=KFC&key=public_key

https://sg-maps.track-asia.com/api/v2/geocode/json?latlng=1.301998,103.81143&key=public_key

outputFormat

outputFormat	Description
`json`	indicates output in JavaScript Object Notation (JSON)
`xml`	indicates output in XML

Parameters

Parameter	Values	Description	Example
`address`	String (required)	address — The street address that you want to geocode. Specify addresses in accordance with the format used by the national postal service of the country concerned. Additional address elements such as business names and unit, suite or floor numbers should be avoided. Street address elements should be delimited by spaces (shown here as url-escaped to %20)
`key`	String (required)	API key	public_key
`size`	Number	The maximum number of results to return from the search.

Response

Geocoding responses are returned in the format indicated by the output flag within the URL request, or in JSON format by default.

In this example, the Geocoding API requests a json response for a query on the address "Landmark 81".

This request demonstrates using the JSON output flag:

https://sg-maps.track-asia.com/api/v2/geocode/json?address=KFC&key=public_key

This request demonstrates using the XML output flag:

https://sg-maps.track-asia.com/api/v2/geocode/xml?address=KFC&key=public_key

JSON Response

{
"status": "OK",
"results": [
{
"place_id": "openstreetmap:venue:node/4700578112",
"name": "KFC",
"sublabel": "Bukit Panjang, WEST REGION, Singapore",
"formatted_address": "KFC, Bukit Panjang, WEST REGION, Singapore",
"address_components": [
{
"long_name": "Bukit Panjang",
"short_name": "Bukit Panjang",
"types": [
"administrative_area_level_2",
"political"
]
},
{
"long_name": "WEST REGION",
"short_name": null,
"types": [
"administrative_area_level_1",
"political"
]
},
{
"long_name": "Singapore",
"short_name": "SG",
"types": [
"country",
"political"
]
}
],
"geometry": {
"location": {
"lat": 1.385118,
"lng": 103.765852
},
"location_type": "ROOFTOP",
"viewport": {
"northeast": {
"lat": 1.3869146223499822,
"lng": 103.76764914747275
},
"southwest": {
"lat": 1.383321377650018,
"lng": 103.76405485252724
}
}
},
"plus_code": {
"compound_code": "9QP8+28 Bukit Panjang, WEST REGION, Singapore",
"global_code": "6PH59QP8+28"
},
"partial_match": false,
"icon": "marker2-11",
"icon_background_color": "#5c6f84",
"types": [
"point_of_interest",
"food",
"retail",
"food:chicken"
]
}
]
}

Example XML Response

<?xml version="1.0" encoding="UTF-8"?>
<GeocodeResponse>
<status>OK</status>
<result>
<place_id>openstreetmap:venue:node/4700578112</place_id>
<name>KFC</name>
<sublabel>Bukit Panjang, WEST REGION, Singapore</sublabel>
<formatted_address>KFC, Bukit Panjang, WEST REGION, Singapore</formatted_address>
<geometry>
<location>
<lat>1.385118</lat>
<lng>103.765852</lng>
</location>
<location_type>ROOFTOP</location_type>
<viewport>
<northeast>
<lat>1.3869146223499822</lat>
<lng>103.76764914747275</lng>
</northeast>
<southwest>
<lat>1.383321377650018</lat>
<lng>103.76405485252724</lng>
</southwest>
</viewport>
</geometry>
<plus_code>
<compound_code>9QP8+28 Bukit Panjang, WEST REGION, Singapore</compound_code>
<global_code>6PH59QP8+28</global_code>
</plus_code>
<partial_match>false</partial_match>
<icon>marker2-11</icon>
<icon_background_color>#5c6f84</icon_background_color>
<types>point_of_interest</types>
<types>food</types>
<types>retail</types>
<types>food:chicken</types>
<address_component>
<long_name>Bukit Panjang</long_name>
<short_name>Bukit Panjang</short_name>
<type>administrative_area_level_2</type>
<type>political</type>
</address_component>
<address_component>
<long_name>WEST REGION</long_name>
<short_name/>
<type>administrative_area_level_1</type>
<type>political</type>
</address_component>
<address_component>
<long_name>Singapore</long_name>
<short_name>SG</short_name>
<type>country</type>
<type>political</type>
</address_component>
</result>
</GeocodeResponse>

Status codes

Status	Description
`OK`	indicates that no errors occurred; the address was successfully parsed and at least one geocode was returned.
`ZERO_RESULTS`	indicates that the geocode was successful but returned no results. This may occur if the geocoder was passed a non-existent address.

When the geocoder returns a status code other than OK, there may be an additional error_message field within the Geocoding response object. This field contains more detailed information about the reasons behind the given status code.