The Search Nearby Search API hostname will be changed from “geodata.gov.hk” to “www.map.gov.hk” with effective on 1st April 2026. During the transition period, the Search Nearby Search API services under both of the aforesaid hostnames will be available before 1st April 2026, but users are strongly recommended to adopt the new hostname (i.e. www.map.gov.hk) as soon as possible to mitigate the impact on the application. Upon 1st April 2026, the Search Nearby Search API services under hostname “geodata.gov.hk” will not be available anymore. Please adopt the new hostname (i.e. www.map.gov.hk) accordingly to avoid any disruption before 1 April 2026.

Search Nearby API provides HTTP-based API for application developers to find the facilities located within 1 km of the search location.

In order to maintain the quality of the Map API service, your application shall not invoke the API with large amount of requests within a short period.

URL Format: Example URL:

• [version] specifies the version number of this API, which is currently "v1.0.0".Notes:The version number may be updated in the future. Old version will be removed at any time without notice. Please check this page to get the list of supported version and update your application(s) accordingly.
• "x" specifies the coordinate value of HK80 Easting (m).
• "y" specifies the coordinate value of HK80 Northing (m).
• "lang" specifies the language in the output JSON.Use value "zh" to get search results in Traditional Chinese.Use value "en" to get search results in English.

The data will be returned in JSON format.

This API uses the standard HTTP status code to indicate the status of the API request.

Query URL