Searches for places within a specified area. You can refine the results by providing a keyword or specifying a place type.

Endpoint

https://maps.track-asia.com/api/v2/place/nearbysearch/{outputFormat}

Output Format

Parameters

Code Examples

This request illustrates using the JSON output flag:

https://maps.track-asia.com/api/v2/place/nearbysearch/json?location=10.76865,106.6681899&radius=100&key=public_key

This request illustrates using the XML output flag:

https://maps.track-asia.com/api/v2/place/nearbysearch/xml?location=10.76865,106.6681899&type=hospital|pharmacy&radius=100&key=public_key

# JSON
curl -G "https://maps.track-asia.com/api/v2/place/nearbysearch/json" \
--data-urlencode "location=10.76865,106.6681899" \
--data-urlencode "type=hospital|pharmacy" \
--data-urlencode "radius=100" \
--data-urlencode "key=public_key"

# XML
curl -G "https://maps.track-asia.com/api/v2/place/nearbysearch/xml" \
--data-urlencode "location=10.76865,106.6681899" \
--data-urlencode "type=hospital|pharmacy" \
--data-urlencode "radius=100" \
--data-urlencode "key=public_key"

// JSON
const response = await fetch("https://maps.track-asia.com/api/v2/place/nearbysearch/json?location=10.76865,106.6681899&radius=100&key=public_key")
const data = await response.json()
console.log(data)

// XML
const responseXML = await fetch("https://maps.track-asia.com/api/v2/place/nearbysearch/xml?location=10.76865,106.6681899&type=hospital|pharmacy&radius=100&key=public_key")
const dataXML = await responseXML.text()
console.log(dataXML)

Response

The response is a JSON object with the following structure:

• status: String status (e.g., "OK")
• html_attributions: Array of HTML attribution strings
• results: Array of result objects. Each object includes:
  • place_id: Unique identifier for the place
  • name: The name of the place
  • formatted_address: The standardized, human-readable address of the place
  • sublabel: Secondary address or additional information
  • address_components: Array of objects with:
    • long_name: The full text description or name
    • short_name: An abbreviated textual name for the address component
    • types: Array of types for the address component
  • geometry: Object with:
    • location: The latitude and longitude coordinates (lat/lng)
    • location_type: The type of location returned
    • viewport: The preferred viewport when displaying the result (northeast/southwest)
  • plus_code: Object with:
    • compound_code: A compound code
    • global_code: A global code
  • types: Array of feature types describing the given result
  • icon: The name of the icon
  • icon_background_color: The background color for the icon
  • class: The primary classification
  • subclass: The secondary classification

The XML response has a similar structure; fields will be corresponding XML tags to the JSON fields above. Some differences:

• The XML results are wrapped in a <PlaceSearchResponse> root element
• Arrays in JSON (like results, address_components, types) will be repeating elements in XML
• Empty fields are represented by empty arrays in JSON but will have no elements in XML

Next steps

• Try the API playground