Skip to content

Retrieves detailed information about a specific place using its unique place_id.

Endpoint

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

Output Format

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

Parameters

Parameter Value Description Example
key String (required) Your API key (use your own key; public_key is limited and for testing only). public_key
place_id String (required) A unique identifier for a place. Used to retrieve details about a specific place. 17:venue:67addea7-6e98-5a17-8769-8399bbcea42f
new_admin Boolean Return address according to new administrative boundaries true
include_old_admin Boolean (Use with new_admin) Return both new and old addresses true

Code Examples

This example demonstrates how to request data in JSON format:

https://maps.track-asia.com/api/v2/place/details/json?place_id=17:venue:67addea7-6e98-5a17-8769-8399bbcea42f&key=public_key&new_admin=true

This example demonstrates how to request data in XML format:

https://maps.track-asia.com/api/v2/place/details/xml?place_id=17:venue:67addea7-6e98-5a17-8769-8399bbcea42f&key=public_key&new_admin=true&include_old_admin=true

# JSON
curl -G "https://maps.track-asia.com/api/v2/place/details//json" \
--data-urlencode "place_id=17:venue:67addea7-6e98-5a17-8769-8399bbcea42f" \
--data-urlencode "key=public_key" \
--data-urlencode "new_admin=true" \
--data-urlencode "include_old_admin=true"

# XML
 curl -G "https://maps.track-asia.com/api/v2/place/details//xml" \
--data-urlencode "place_id=17:venue:67addea7-6e98-5a17-8769-8399bbcea42f" \
--data-urlencode "key=public_key" \
--data-urlencode "new_admin=true" \
--data-urlencode "include_old_admin=true"

// JSON
const response = await fetch("https://maps.track-asia.com/api/v2/place/details/json?place_id=17:venue:67addea7-6e98-5a17-8769-8399bbcea42f&key=public_key&new_admin=true")
const data = await response.json()
console.log(data)

// XML
const response = await fetch("https://maps.track-asia.com/api/v2/place/details/xml?place_id=17:venue:67addea7-6e98-5a17-8769-8399bbcea42f&key=public_key&new_admin=true&include_old_admin=true")
const data = await response.text()
console.log(data)

Response

JSON Response

The response is a JSON object with the following structure:

  • status: String status (e.g., "OK")
  • html_attributions: Array of HTML attribution strings
  • result: Object containing detailed information about the place, such as:
    • place_id: Unique identifier for the place
    • name: Name of the place
    • formatted_address: The standardized, human-readable address
    • vicinity: Short address or vicinity (if available)
    • adr_address: Address string with HTML tags for UI formatting (if available)
    • editorial_summary: Object with an overview field (if available)
    • address_components: Array of objects with:
      • long_name: Full text description or name
      • short_name: Abbreviated name
      • types: Array of types for the address component
      • official_id: Official identifier based on the National Directory of Administrative Units
    • geometry: Object with:
      • location: Latitude and longitude coordinates (lat/lng)
      • location_type: Type of location
      • viewport: Preferred viewport (northeast/southwest)
    • plus_code: Object with:
      • compound_code: A compound code
      • global_code: A global code
    • types: Array of feature types
    • icon: Name of the icon
    • icon_background_color: Background color for the icon
    • photos: Array of photo objects (if available)
      • url: URL to the photo
    • opening_hours: Object with opening hours info (if available)
    • rating: Place rating (if available)
    • user_ratings_total: Number of user ratings (if available)
    • website: Place website (if available)
    • phone_number: Place phone number (if available)
    • socials: Array of social media URLs (if available)
    • url: Link to the place on TrackAsia Maps (if available)
    • utc_offset: Offset from UTC in minutes (if available)
    • old_address_components: (Only present when include_old_admin=true) Array of address components according to the old boundaries, same structure as address_components.
    • old_formatted_address: (Only present when include_old_admin=true) Full formatted address according to the old boundaries.
XML Response

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 <PlaceDetailResponse> root element
  • Arrays in JSON will be repeating elements in XML
  • Empty fields are represented by empty arrays in JSON but will have no elements in XML

Important Notes

Status

Status Description
OK indicates that no errors occurred; the request was successful and details were returned.
ZERO_RESULTS indicates that the request was successful but returned no results.
INVALID_REQUEST indicates that the API request was malformed (e.g., missing required parameters, invalid parameter values).

Error

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

Next steps