The Location 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 Location 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 Location 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.

Location Search API provides HTTP-based API for application developers to find the location by its address, building name, place name or facility name.

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.
• "q" specifies the input string to search, such as addresses, building names, place names or facility names.

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