{"templateId":"markdown","versions":[{"version":"latest","label":"latest","link":"/guides/search/latest/details","default":false,"active":true,"folderId":"e17c1af6"},{"version":"v1.0","label":"v1.0","link":"/guides/search/v1.0/details","default":true,"active":false,"folderId":"e17c1af6"}],"sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Place Details","description":"Digime Map is the groundbreaking API that allows you to search places, navigate between points, highlight street attributes and raster tile.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"place-details","__idx":0},"children":["Place Details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retrieves detailed information about a specific place using its unique ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["place_id"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request","__idx":1},"children":["Request"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"endpoint","__idx":2},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://dplace-api.themap.world/maps/api/place/details/json\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"query-params","__idx":3},"children":["Query params"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Param"},"children":["Param"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["place_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A single ID in the format ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source:layer:id"]},", for example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["osm:venue:b467e12f..."]},". If the ID has an invalid format or an unsupported layer, the request fails with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["has_deprecated_admin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," if you want to return old_formatted_address, old_address_components"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example","__idx":4},"children":["Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --location 'https://dplace-api.themap.world/maps/api/place/details/json?place_id=4:venue:b467e12f599e45838c0924d8e85c5fd9&has_deprecated_admin=true&key=YOUR_API_KEY'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response","__idx":5},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details/json"]}," wraps the response in the following top-level fields:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"When present"},"children":["When present"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Content"},"children":["Content"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OK"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ZERO_RESULTS"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOT_FOUND"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVALID_REQUEST"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNKNOWN_ERROR"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_message"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVALID_REQUEST"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNKNOWN_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["error description"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["info_messages"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["when there is a parameter warning"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of strings"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["html_attributions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[]"]}," — no third-party attribution data"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"status","__idx":6},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OK"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["success, place found"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["place_id"]}," does not exist"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVALID_REQUEST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["missing or invalid parameter (HTTP 400)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNKNOWN_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["server-side error: timeout, backend unreachable (HTTP 502/500)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"result","__idx":7},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["result"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The fields shown in the example response body above:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"When present"},"children":["When present"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Content"},"children":["Content"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["place_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["unique identifier for the place"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["numeric source ID for the place data"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["place name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["formatted_address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["standardized full address"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address_components"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{long_name, short_name, types}"]}," components of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["formatted_address"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["old_formatted_address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["address before an administrative merge, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"\""]}," if none"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["old_address_components"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["old_formatted_address"]}," is non-empty"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{long_name, short_name, types}"]}," components of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["old_formatted_address"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["geometry"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["location"]}," (lat/lng) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["viewport"]}," (northeast/southwest bounds)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["types"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of place type classifications"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["category"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["top-level place category"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subcategory"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["place subcategory"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["plus_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["when available in the source data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Open Location Code for the place"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["when available in the source data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OPERATIONAL"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["place_id"]}," does not exist, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOT_FOUND"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["result"]}," is an empty object (not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"status\": \"NOT_FOUND\",\n  \"html_attributions\": [],\n  \"result\": {}\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the request has an invalid parameter, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/v3/"]}," still returns HTTP 200 with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status: \"INVALID_REQUEST\""]}," and keeps ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["result"]}," in the body:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"status\": \"INVALID_REQUEST\",\n  \"error_message\": \"id `abc is invalid: must be of the format source:layer:id for ex: '4:venue:ffb627dc81f845e59b5c0259582ad101'\",\n  \"result\": {},\n  \"html_attributions\": [],\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-1","__idx":8},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"status\": \"OK\",\n  \"result\": {\n    \"place_id\": \"4:venue:ffb627dc81f845e59b5c0259582ad101\",\n    \"source\": 4,\n    \"name\": \"Cơm tấm Huyền Trang\",\n    \"formatted_address\": \"3 Đường Lương Văn Can, Phường Phú Định, Thành phố Hồ Chí Minh, Việt Nam\",\n    \"address_components\": [\n      {\n        \"long_name\": \"3\",\n        \"short_name\": \"3\",\n        \"types\": [\n          \"street_number\"\n        ]\n      },\n      {\n        \"long_name\": \"Đường Lương Văn Can\",\n        \"short_name\": \"Đường Lương Văn Can\",\n        \"types\": [\n          \"route\"\n        ]\n      },\n      {\n        \"long_name\": \"Phường Phú Định\",\n        \"short_name\": \"Phường Phú Định\",\n        \"types\": [\n          \"administrative_area_level_2\"\n        ]\n      },\n      {\n        \"long_name\": \"Thành phố Hồ Chí Minh\",\n        \"short_name\": \"Thành phố Hồ Chí Minh\",\n        \"types\": [\n          \"administrative_area_level_1\"\n        ]\n      },\n      {\n        \"long_name\": \"Việt Nam\",\n        \"short_name\": \"VN\",\n        \"types\": [\n          \"country\"\n        ]\n      }\n    ],\n    \"old_formatted_address\": \"3 Đường Lương Văn Can, Phường 15, Quận 8, Thành phố Hồ Chí Minh, Việt Nam\",\n    \"old_address_components\": [\n      {\n        \"long_name\": \"3\",\n        \"short_name\": \"3\",\n        \"types\": [\n          \"street_number\"\n        ]\n      },\n      {\n        \"long_name\": \"Đường Lương Văn Can\",\n        \"short_name\": \"Đường Lương Văn Can\",\n        \"types\": [\n          \"route\"\n        ]\n      },\n      {\n        \"long_name\": \"Phường 15\",\n        \"short_name\": \"Phường 15\",\n        \"types\": [\n          \"administrative_area_level_3\"\n        ]\n      },\n      {\n        \"long_name\": \"Quận 8\",\n        \"short_name\": \"Quận 8\",\n        \"types\": [\n          \"administrative_area_level_2\"\n        ]\n      },\n      {\n        \"long_name\": \"Thành phố Hồ Chí Minh\",\n        \"short_name\": \"Thành phố Hồ Chí Minh\",\n        \"types\": [\n          \"administrative_area_level_1\"\n        ]\n      },\n      {\n        \"long_name\": \"Việt Nam\",\n        \"short_name\": \"VN\",\n        \"types\": [\n          \"country\"\n        ]\n      }\n    ],\n    \"geometry\": {\n      \"location\": {\n        \"lat\": 10.73602,\n        \"lng\": 106.63923\n      },\n      \"viewport\": {\n        \"northeast\": {\n          \"lat\": 10.73692,\n          \"lng\": 106.64043\n        },\n        \"southwest\": {\n          \"lat\": 10.73512,\n          \"lng\": 106.63803\n        }\n      }\n    },\n    \"types\": [\n      \"food_and_drink\",\n      \"restaurant\"\n    ],\n    \"category\": \"food_and_drink\",\n    \"subcategory\": \"restaurant\",\n    \"plus_code\": \"7P28PJPQCM5\",\n    \"business_status\": \"OPERATIONAL\"\n  },\n  \"html_attributions\": []\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Place Details","id":"place-details","depth":2},{"value":"Request","id":"request","depth":3},{"value":"Endpoint","id":"endpoint","depth":4},{"value":"Query params","id":"query-params","depth":4},{"value":"Example","id":"example","depth":4},{"value":"Response","id":"response","depth":3},{"value":"status","id":"status","depth":4},{"value":"result","id":"result","depth":4},{"value":"Example:","id":"example-1","depth":4}],"frontmatter":{"seo":{"title":"Place Details"}},"lastModified":"2026-09-14T02:30:47.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/search/latest/details","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}