{"help": "https://data.gov.hk/en-data/api/3/action/help_show?name=package_show", "success": true, "result": {"announcement": "Starting from 25th July 2024, please switch to the new domain \"als.gov.hk\".  The current domain will be suspended effective from 1st August 2024 and will no longer be accessible.", "announcementEndDate": "2025-06-19", "announcementStartDate": "2024-06-18", "author": null, "author_email": null, "creator_user_id": "77dc1126-bc02-45e6-a89b-bf2c5ae85737", "data_dictionary": "https://www.als.gov.hk/docs/Data_Dictionary_for_ALS_EN.pdf", "id": "99512f5f-0492-48a5-b5ac-03402e3c8396", "isopen": false, "license_id": null, "license_title": null, "maintainer": "ADI Programme Office", "maintainer_email": "adi@digitalpolicy.gov.hk", "maintainer_phone": "38556952", "metadata_created": "2024-07-24T12:14:44.489354", "metadata_modified": "2026-07-22T16:32:15.417009", "name": "hk-dpo-als_01-als", "notes": "1.Address Lookup Service (ALS) is a web service providing lookup function on Hong Kong address records in both Chinese and English aggregated from various Government Bureaux/Departments. This web service allows data consumers to look up address records in machine-readable format (XML or JSON) using address element information. It aims to facilitate development of applications with the need to capture Hong Kong address information more efficiently and accurately.\n\n 2.The ALS provides formatted addresses of the premises in Hong Kong, including private and public housing estates, commercial and industrial buildings, government buildings and offices, markets and shopping centers; and common facilities such as recreation and sports centres. Some addresses provided are representing a complex of buildings, such as schools or universities. Most of the addresses in ALS are available in 2-Dimensional format which typically includes up to street name, building number and building name. 3-Dimensional formatted addresses, such as addresses include flat number and floor number, they are only available for public housing estates. For more details, please refer the Data Dictionary.\n\n 3.This service also includes unofficial descriptions of buildings which are long established addresses in rural areas of the New Territories and are generally accepted by the public.\n\n 4.The choice of name for a building is a matter for the owner, and at present there is no controlling legislation. The inclusion of a building name in this service confers no proprietary right to it or any part of it.\n\n 5.As there are no regulations requiring owners or developers to report or register building names, the ALS is not exhaustive. The accuracy and timeliness of its contents cannot be guaranteed. Particularly for some new buildings, the confirmation of address particulars involves business processes and coordination of multiple departments, such as surveying, reviewing data, and assigning geographical addresses, etc., which can take time to complete. Nonetheless, every effort has been made to include all known names and to check the correctness of entries. We welcome notifications from any source of new names, changes in existing names, the discontinuation of the use of names, and any omissions or errors in this service. Please contact us via email at [adi@digitalpolicy.gov.hk](mailto:adi@digitalpolicy.gov.hk). \n\n 6.The ALS enables data consumers to quickly retrieve full formatted address records by inputting basic address elements. Recommended input formats include \n (a) building name, for example, \u201cMONGKOK GOVERNMENT OFFICES\u201d, \u201cLAI CHI KOK GOVERNMENT OFFICES\u201d, or \n (b) street name and number, for example, \u201c30 LUEN WAN STREET\u201d, \u201c19 LAI WAN ROAD\u201d, or \n (c) estate name and building block number, for example, \u201c25 PARK ROAD GOVERNMENT QUARTERS BLOCK A\u201d, \u201cTSING CHUNG KOON ROAD GOVERNMENT QUARTERS BLOCK F\u201d, or \n (d) It is recommended to adopt the Hongkong Post\u2019s Mailing Address Format, in the order of: unit, floor, building name, street number, street name, district, and region (Hong Kong / Kowloon / New Territories) (e.g. 100 Cyberport Road Pokfulam Hong Kong).\n  Following the above search input format helps improve the search accuracy.\n\n 7.Why is the search accuracy slightly lower when using the ALS? \n (a) If entering \u201cHong Kong Special Administrative Region\u201d: Since the ALS provides search for addresses located within the Hong Kong Special Administrative Region only, there is no need to additionally input \u201cHong Kong Special Administrative Region.\u201d; \n (b) If entering non-address information (for example: elderly homes, kindergartens, hotels, or other institution details, etc.): The ALS does not provide search functions for non-address information.\n  Any such extra input as illustrated above will affect the search results.", "num_resources": 5, "num_tags": 0, "organization": {"id": "d47bf947-7275-445a-92d3-dea506423d1e", "name": "hk-dpo", "title": "Digital Policy Office", "type": "organization", "description": "", "image_url": "https://data.gov.hk/filestore/provider-images/hk-dpo.png", "created": "2024-07-24T20:12:01.668880", "is_organization": true, "approval_status": "approved", "state": "active"}, "owner_org": "d47bf947-7275-445a-92d3-dea506423d1e", "private": false, "state": "active", "title": "Address Lookup Service", "type": "dataset", "update_frequency": "Monthly", "url": null, "version": null, "groups": [{"description": "", "display_name": "Housing", "id": "a775995d-01de-40a4-abe1-1a771fd24da1", "image_display_url": "", "name": "housing", "title": "Housing"}], "resources": [{"cache_last_updated": null, "cache_url": null, "created": "2026-07-22T16:32:12.379301", "dateCreated": "2015-09-30", "datePublished": "2015-09-30", "description": "### GET request:\n    https://www.als.gov.hk/lookup?q=<input address in free text format>\n### POST request:\n    POST /lookup HTTP/1.1\n    Host: www.als.gov.hk\n    Content-Type: application/x-www-form-urlencoded; charset=utf-8\n    Content-Length: <number of bytes in the body of the request>\n    q=<input address in free-text format>\n### Notes:\nThis web service allows data consumers to look up address records using simple address element information [for example (a) building name, (b) street name and number or (c) estate name and block number]. The service will also search for addresses with spelling or pronunciation similar to the user input information for reference use.\n+ Input parameters:\n+ \"q\" \u2013 input address element information (mandatory; URL-encoded(percent-encoded)); \n+ \"n\" \u2013 maximum number of records to be returned (optional; range: 1-200; default: 200); \n+ \"t\" \u2013 tolerance on returned record scores (optional; range: 0-80; default: 20);\n+ \"b\" \u2013 enable/disable basic searching mode, default disabled (optional; range: 0 or 1; default: 0).\n+ The request and response are encoded in UTF-8.\n+ The **data output format, language** (Chinese / English / Both Chinese and English) and **compression method** can be specified using the HTTP header parameters: Accept=application/xml, Accept-Language=en,zh-Hant and Accept-Encoding=gzip \n+ Please refer to the \"Data Dictionary\" for details.", "format": "XML", "hash": "", "id": "d8e4718c-a4ee-481e-9806-3287df95a5e9", "inLanguage": "en, zh-Hant", "is_api": "Y", "last_modified": null, "metadata_modified": "2026-07-22T16:32:12.373893", "mimetype": null, "mimetype_inner": null, "name": "Request format for Address Lookup Service (XML Output)", "package_id": "99512f5f-0492-48a5-b5ac-03402e3c8396", "position": 0, "resource_type": null, "schema": "https://www.als.gov.hk/docs/AddressLookupResult.xsd", "shared_id": "e43efa7e85ea11f1ac3a0a58c0a828e4", "size": null, "state": "active", "url": "https://www.als.gov.hk/lookup?q=central%20government%20offices", "url_type": null}, {"cache_last_updated": null, "cache_url": null, "created": "2026-07-22T16:32:13.180285", "dateCreated": "2015-09-30", "datePublished": "2015-09-30", "description": "### GET request:\n    https://www.als.gov.hk/lookup?q=<input address in free text format>\n### POST request:\n    POST /lookup HTTP/1.1\n    Host: www.als.gov.hk\n    Content-Type: application/x-www-form-urlencoded; charset=utf-8\n    Content-Length: <number of bytes in the body of the request>\n    q=<input address in free-text format>\n### Notes:\nThis web service allows data consumers to look up address records using simple address element information [for example (a) building name, (b) street name and number or (c) estate name and block number]. The service will also search for addresses with spelling or pronunciation similar to the user input information for reference use.\n+ Input parameters:\n+ \"q\" \u2013 input address element information (mandatory; URL-encoded(percent-encoded)); \n+ \"n\" \u2013 maximum number of records to be returned (optional; range: 1-200; default: 200); \n+ \"t\" \u2013 tolerance on returned record scores (optional; range: 0-80; default: 20);\n+ \"b\" \u2013 enable/disable basic searching mode, default disabled (optional; range: 0 or 1; default: 0). \n+ The request and response are encoded in UTF-8.\n+ The **data output format, language** (Chinese / English / Both Chinese and English) and **compression method** can be specified using the HTTP header parameters: Accept=application/json, Accept-Language=en,zh-Hant and Accept-Encoding=gzip \n+ Please refer to the \"Data Dictionary\" for details.", "format": "JSON", "hash": "", "id": "20bac7af-847e-4f99-83c4-0d087ce87f21", "inLanguage": "en, zh-Hant", "is_api": "Y", "last_modified": null, "metadata_modified": "2026-07-22T16:32:13.173944", "mimetype": null, "mimetype_inner": null, "name": "Request format for Address Lookup Service (JSON Output)", "package_id": "99512f5f-0492-48a5-b5ac-03402e3c8396", "position": 1, "resource_type": null, "shared_id": "e4b84b4a85ea11f1ac3a0a58c0a828e4", "size": null, "state": "active", "url": "https://www.als.gov.hk/lookup?q=central%20government%20offices", "url_type": null}, {"cache_last_updated": null, "cache_url": null, "created": "2026-07-22T16:32:13.888640", "dateCreated": "2020-02-28", "datePublished": "2020-02-28", "description": "### GET request:\n    https://www.als.gov.hk/galookup?ga=<input GeoAddress>\n### POST request:\n    POST /galookup HTTP/1.1\n    Host: www.als.gov.hk\n    Content-Type: application/x-www-form-urlencoded\n    Content-Length: <number of bytes in the body of the request>\n    ga=<input GeoAddress>\n\n### Notes:\nThis web service allows data consumers to look up address records using GeoAddress.\n+ Input parameters:\n+ \"ga\" \u2013 input GeoAddress (mandatory; 19 characters string); \n+ \"n\" \u2013 maximum number of records to be returned (optional; range: 1-200; default: 200).\n+ The request and response are encoded in UTF-8.\n+ The **data output format, language** (Chinese / English / Both Chinese and English) and **compression method** can be specified using the HTTP header parameters: Accept=application/xml, Accept-Language=en,zh-Hant and Accept-Encoding=gzip \n+ Please refer to the \"Data Dictionary\" for details.", "format": "XML", "hash": "", "id": "8377f3c8-f3fe-47c9-b480-173449433259", "inLanguage": "en, zh-Hant", "is_api": "Y", "last_modified": null, "metadata_modified": "2026-07-22T16:32:13.883803", "mimetype": null, "mimetype_inner": null, "name": "Request format for GeoAddress Lookup Service (XML Output)", "package_id": "99512f5f-0492-48a5-b5ac-03402e3c8396", "position": 2, "resource_type": null, "schema": "https://www.als.gov.hk/docs/AddressLookupResult.xsd", "shared_id": "e524953e85ea11f1ac3a0a58c0a828e4", "size": null, "state": "active", "url": "https://www.als.gov.hk/galookup?ga=3508215732T20110704", "url_type": null}, {"cache_last_updated": null, "cache_url": null, "created": "2026-07-22T16:32:14.665943", "dateCreated": "2020-02-28", "datePublished": "2020-02-28", "description": "### GET request:\n    https://www.als.gov.hk/galookup?ga=<input GeoAddress>\n### POST request:\n    POST /galookup HTTP/1.1\n    Host: www.als.gov.hk\n    Content-Type: application/x-www-form-urlencoded\n    Content-Length: <number of bytes in the body of the request>\n    ga=<input GeoAddress>\n\n### Notes:\nThis web service allows data consumers to look up address records using GeoAddress.\n+ Input parameters:\n+ \"ga\" \u2013 input GeoAddress (mandatory; 19 characters string); \n+ \"n\" \u2013 maximum number of records to be returned (optional; range: 1-200; default: 200).\n+ The request and response are encoded in UTF-8.\n+ The **data output format, language** (Chinese / English / Both Chinese and English) and **compression method** can be specified using the HTTP header parameters: Accept=application/json, Accept-Language=en,zh-Hant and Accept-Encoding=gzip \n+ Please refer to the \"Data Dictionary\" for details.", "format": "JSON", "hash": "", "id": "7d2af314-4fe3-4df2-8e9d-6d0116eabb34", "inLanguage": "en, zh-Hant", "is_api": "Y", "last_modified": null, "metadata_modified": "2026-07-22T16:32:14.661272", "mimetype": null, "mimetype_inner": null, "name": "Request format for GeoAddress Lookup Service (JSON Output)", "package_id": "99512f5f-0492-48a5-b5ac-03402e3c8396", "position": 3, "resource_type": null, "shared_id": "e59b37fc85ea11f1ac3a0a58c0a828e4", "size": null, "state": "active", "url": "https://www.als.gov.hk/galookup?ga=3508215732T20110704", "url_type": null}, {"cache_last_updated": null, "cache_url": null, "created": "2026-07-22T16:32:15.431262", "dateCreated": "2022-12-01", "datePublished": "2022-12-01", "description": "Hong Kong address records in both Chinese and English aggregated from various Government Bureaux/Departments.", "format": "JSON", "hash": "", "id": "92eed8bd-9e6f-4aac-9c9a-5ea6f5dbb4b8", "inLanguage": "en, zh-Hant", "is_api": "N", "last_modified": null, "metadata_modified": "2026-07-22T16:32:15.425614", "mimetype": null, "mimetype_inner": null, "name": "Addresses from Address Lookup Service", "package_id": "99512f5f-0492-48a5-b5ac-03402e3c8396", "position": 4, "resource_type": null, "schema": "https://www.als.gov.hk/docs/als-geojson.schema.json", "shared_id": "e60f2bbc85ea11f1ac3a0a58c0a828e4", "size": null, "state": "active", "url": "https://www.als.gov.hk/data/ALS-GeoJSON.zip", "url_type": null}], "tags": [], "relationships_as_subject": [], "relationships_as_object": []}}