en

Identify API

Description
Identify API provides HTTP-based API for application developers to identify the information of a facility at a selected geographic location.
Important Notice on Identify API
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.
API URL
URL Format: 
https://geodata.gov.hk/gs/api/[version]/identify?x=[value]&y=[value]&lang=[value]
Example URL:
Query Parameters
  • [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.
Response
The data will be returned in JSON format.
Status Codes
This API uses the standard HTTP status code to indicate the status of the API request.

Status Code Description
200 OK
400 Bad Request.  e.g. invalid query parameters
500 Internal Server Error
Build a Query URL
Description Parameter Value
x
y
Language lang
Query URL
Contact Information
Contact
Organisation Lands Department
Position GeoInfo Map Support Team
Email Address geoinfomap@landsd.gov.hk
Text Copied
Text Copy Failed, URL to you to copy: