{"templateId":"markdown","versions":[{"version":"latest","label":"latest","link":"/guides/search/latest/nearbysearch","default":false,"active":true,"folderId":"e17c1af6"},{"version":"v1.0","label":"v1.0","link":"/guides/search/v1.0/nearbysearch","default":true,"active":false,"folderId":"e17c1af6"}],"sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Nearby Search","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":"nearby-search","__idx":0},"children":["Nearby Search"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Searches for places within a specific area. You can refine results by providing a keyword or specifying a place type."]},{"$$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/nearbysearch/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":["location"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Center coordinate, format ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{lat},{lng}"]}," (latitude first), for example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10.7952219,106.7217912"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["radius"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search radius around ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["location"]},", in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["meters"]},", max ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["50000"]},", for example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["5000"]}," (= 5km)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One or more place types to filter results, separated by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["|"]},", for example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hospital|pharmacy"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["keyword"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Keyword to filter nearby results, for example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"tạp hóa\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["size"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number of results returned"]}]},{"$$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":"type-values","__idx":4},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," values"]},{"$$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":"Category"},"children":["Category"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"types"},"children":["types"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["food_and_drink"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["food_and_drink"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["restaurant"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vietnamese_restaurant"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["asian_restaurant"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["japanese_restaurant"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["korean_restaurant"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chinese_restaurant"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["thai_restaurant"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["western_restaurant"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["italian_restaurant"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["american_restaurant"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vegetarian_restaurant"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fast_food"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["food_court"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["street_food"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["buffet_restaurant"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["diner"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bakery"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cafe"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tea_house"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bubble_tea_shop"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["juice_shop"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smoothie_shop"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ice_cream_shop"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dessert_shop"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["beer_garden"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["wine_bar"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cocktail_bar"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shopping"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shopping"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["book_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vehicle_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["computer_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["convenience_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["electronics_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appliance_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cell_phone_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["florist"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["grocery_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["market"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["furniture_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shopping_mall"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supermarket"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fashion_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jewelry_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shoe_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pet_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hardware_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["liquor_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gift_shop"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sporting_goods_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["toy_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cosmetics_store"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["optician"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["services"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hair_salon"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nail_salon"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["barber_shop"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["spa"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["car_repair"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["car_wash"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["motorcycle_repair"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mobile_phone_repair"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["electronics_repair"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gas_station"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["laundry_service"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parking_lot"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["photography_studio"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tailor"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["funeral_home"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["travel_agency"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["real_estate_agency"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notary"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["printing_shop"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["veterinary_care"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["internet_cafe"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pet_care"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finance"]},",",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bank"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["atm"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["insurance_agency"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["money_exchange"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pawn_shop"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accounting"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hotels_and_lodging"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hotels_and_lodging"]},",",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hotel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["motel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["villa"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["homestay"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lodging"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guest_house"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resort"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hostel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["serviced_apartment"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entertainment_and_recreation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entertainment_and_recreation"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dance_club"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hiking_area"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["historical_landmark"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["museum"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["park"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["playground"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tourist_attraction"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["casino"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["garden"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["karaoke"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["live_music_venue"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["wedding_venue"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["event_venue"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["movie_theater"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["night_club"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["plaza"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["zoo"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sports"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sports"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arena"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["golf_course"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gym"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["yoga"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sport_club"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stadium"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["swimming_pool"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tennis_court"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["badminton_court"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["basketball_court"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fishing_pond"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transportation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transportation"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["airport"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["international_airport"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bridge"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bus_station"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bus_stop"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subway_station"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["train_station"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transportation_service"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxi_stand"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parking_garage"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ferry_terminal"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["port"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["health_and_wellness"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["health_and_wellness"]},",",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hospital"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clinic"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dental_clinic"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["skin_care_clinic"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pharmacy"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["medical_center"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["optometrist"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["physiotherapy"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["traditional_medicine"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["massage"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["religion"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["religion"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["church"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pagoda"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["place_of_worship"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["buddhist_temple"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hindu_temple"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["office_and_industrial"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["office_and_industrial"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_office"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["corporate_office"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["farm"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ranch"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["manufacturer"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["industrial_park"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["factory"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["residential"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["residential"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["government"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["government"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["government_office"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["city_hall"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fire_station"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["police"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["post_office"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["embassy"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cemetery"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["courthouse"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["local_government_office"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customs"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["education"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["education"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["university"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["college"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["high_school"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["secondary_school"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["primary_school"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kindergarten"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["preschool"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["driving_school"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["education_center"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["research_institute"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language_school"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["music_school"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["library"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vocational_school"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["school"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["automotive"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["automotive"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["car_dealer"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["car_rental"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["car_repair"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["car_wash"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ebike_charging_station"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["electric_vehicle_charging_station"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gas_station"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parking"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parking_garage"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parking_lot"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rental_car_agency"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rest_stop"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tire_shop"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truck_dealer"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["motorcycle_repair"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["motorcycle_wash"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["natural_features"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["natural_features"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["body_of_water"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["beach"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["island"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lake"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mountain"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mountain_peak"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["river"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["woods"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["forest"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["point_of_interest"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["point_of_interest"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example","__idx":5},"children":["Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --location 'https://dplace-api.themap.world/maps/api/place/nearbysearch/json?location=10.792981,106.639812&radius=5000&keyword=cửa hàng&has_deprecated_admin=true&key=YOUR_API_KEY'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response","__idx":6},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nearbysearch/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":["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":["results"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of place objects (empty array on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ZERO_RESULTS"]}," / errors)"]}]},{"$$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":["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":7},"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, results found"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ZERO_RESULTS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["success but no results matched"]}]},{"$$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":"results","__idx":8},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["results"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each item in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["results"]}," is a place object with 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":["distance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["distance from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["location"]},", in km"]}]},{"$$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":["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":["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":"Heading","attributes":{"level":4,"id":"error_message","__idx":9},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_message"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the request has an invalid parameter, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nearbysearch/json"]}," still returns HTTP 200 with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status: \"INVALID_REQUEST\""]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"status\": \"INVALID_REQUEST\",\n  \"error_message\": \"radius must be between 1 and 50000\",\n  \"results\": [],\n  \"html_attributions\": []\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On a server-side failure, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNKNOWN_ERROR"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"status\": \"UNKNOWN_ERROR\",\n  \"error_message\": \"backend unreachable\",\n  \"results\": [],\n  \"html_attributions\": []\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-1","__idx":10},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"status\": \"OK\",\n  \"results\": [\n    {\n      \"place_id\": \"4:venue:fece07bb108e4cccbfde40678984c3c4\",\n      \"distance\": 0.12,\n      \"name\": \"Tạp Hóa Tuyên Huyền\",\n      \"formatted_address\": \"Đường Âu Cơ, Phường Tân Phú, Thành phố Hồ Chí Minh, Việt Nam\",\n      \"old_formatted_address\": \"Đường Âu Cơ, Phường Tân Thành, Quận Tân Phú, Thành phố Hồ Chí Minh, Việt Nam\",\n      \"geometry\": {\n        \"location\": {\n          \"lat\": 10.793547630310059,\n          \"lng\": 106.63887786865234\n        },\n        \"viewport\": {\n          \"northeast\": {\n            \"lat\": 10.794447630310058,\n            \"lng\": 106.64007786865234\n          },\n          \"southwest\": {\n            \"lat\": 10.792647630310059,\n            \"lng\": 106.63767786865235\n          }\n        }\n      },\n      \"types\": [\n        \"shopping\"\n      ]\n    },\n    {\n      \"place_id\": \"4:venue:779e3879dc4f47c9beac52899e110b3d\",\n      \"distance\": 0.319,\n      \"name\": \"Tạp Hóa Thu Trang\",\n      \"formatted_address\": \"Đường Vạn Hạnh, Phường Tân Sơn Nhì, Thành phố Hồ Chí Minh, Việt Nam\",\n      \"old_formatted_address\": \"Đường Vạn Hạnh, Phường Tân Thành, Quận Tân Phú, Thành phố Hồ Chí Minh, Việt Nam\",\n      \"geometry\": {\n        \"location\": {\n          \"lat\": 10.794112205505371,\n          \"lng\": 106.63713073730469\n        },\n        \"viewport\": {\n          \"northeast\": {\n            \"lat\": 10.79501220550537,\n            \"lng\": 106.63833073730468\n          },\n          \"southwest\": {\n            \"lat\": 10.793212205505371,\n            \"lng\": 106.63593073730469\n          }\n        }\n      },\n      \"types\": [\n        \"shopping\"\n      ]\n    }\n  ],\n  \"html_attributions\": []\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Nearby Search","id":"nearby-search","depth":2},{"value":"Request","id":"request","depth":3},{"value":"Endpoint","id":"endpoint","depth":4},{"value":"Query params","id":"query-params","depth":4},{"value":"type values","id":"type-values","depth":4},{"value":"Example","id":"example","depth":4},{"value":"Response","id":"response","depth":3},{"value":"status","id":"status","depth":4},{"value":"results","id":"results","depth":4},{"value":"error_message","id":"error_message","depth":4},{"value":"Example:","id":"example-1","depth":4}],"frontmatter":{"seo":{"title":"Nearby Search"}},"lastModified":"2026-09-14T02:30:47.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/search/latest/nearbysearch","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}