Hyppää pääsisältöön
<< Takaisin Hongkong julkaisuihin

Hongkongin ISO-koodit: HK, HKG ja 344 selitettyinä

Preview image for the video "DNS-asetusten muuttaminen HKDNR-verkkotunnuksille (.com.hk JA .hk)".
DNS-asetusten muuttaminen HKDNR-verkkotunnuksille (.com.hk JA .hk)

Hongkongin ISO-koodia etsiessä voi saada useita erilaisia vastauksia, koska maa-, puhelin-, valuutta-, urheilu- ja internetjärjestelmät käyttävät erillisiä tunnisteita. Hongkongin ISO 3166-1 -koodit ovat HK, HKG ja 344. Tässä oppaassa selitetään, mitä kukin muoto tarkoittaa, miksi HKG voi esiintyä myös olympialaistiedoissa ja miten ISO-koodit pidetään erillään koodeista +852, HKD, .hk ja .香港 lomakkeissa, ohjelmistoissa ja taloustiedoissa.

Hongkongin ISO-koodit: nopea vastaus

Hongkongilla on kolme ISO 3166-1 -esitysmuotoa: kaksikirjaiminen alpha-2-koodi, kolmikirjaiminen alpha-3-koodi ja numeerinen koodi. Oikea arvo riippuu kentästä tai järjestelmästä, joka vastaanottaa tiedot.

Kolme ISO 3166-1 -koodia yhdellä silmäyksellä

ISO-koodin tyyppiHongkongin arvoTyypillinen käyttötarkoitus
Alpha-2HKLyhyet maakentät ja yleinen tiedonsiirto
Alpha-3HKGKolmikirjaimiset maatietoaineistot ja jotkin urheilutiedot
Numeerinen344Tilastolliset, vanhat ja vain numeerisia arvoja käyttävät järjestelmät

Toinen ISO-maaluettelo lähteestä Docebo Help & Support tunnistaa Hongkongin myös alpha-2-arvolla HK. Puhelusuuntanumero, valuuttakoodi, olympiakoodi ja internet-verkkotunnukset eivät ole ISO 3166-1:n lisämuotoja. Ne kuuluvat eri standardeille tai organisaatioille.

Hongkongin kolme ISO 3166-1 -koodia selitettyinä

Kolme ISO-muotoa edustavat samaa maantieteellistä kohdetta eri tavoin. Niitä ei voi käyttää kaikissa sovelluksissa ristiin, joten vastaanottavan järjestelmän dokumentaation tulee määrittää, minkä arvon lähetät tai tallennat.

ISO alpha-2 -koodi: HK

HK on Hongkongin kaksikirjaiminen ISO 3166-1 alpha-2 -tunniste. Se on kompakti muoto, jota pyydetään useimmiten, kun yleinen maakenttä edellyttää ISO alpha-2 -arvoa. Esimerkiksi tätä standardia varten suunniteltu tietokanta voisi tallentaa arvon country_alpha2 = HK.

HK ei ole sama kuin kansainvälinen puhelusuuntanumero +852. Se ei myöskään ole sama kuin verkkotunnuksen loppuosa .hk, vaikka kirjaimet liittyvätkin toisiinsa. Ensimmäinen on ISO-maan arvo, toista käytetään puhelinnumeroinnissa ja kolmas on DNS-tunniste.

Käytä HK:ta, kun lomakkeessa, API:ssa tai tietomäärityksessä sanotaan selvästi, että odotettu arvo on ISO 3166-1 alpha-2. Älä oleta, että jokainen maakoodiksi nimetty kenttä käyttää tätä muotoa. Jotkin palvelut edellyttävät koko nimeä, alpha-3-arvoa, numeerista arvoa tai palveluntarjoajakohtaista koodia.

ISO alpha-3 -koodi: HKG

HKG on Hongkongin kolmikirjaiminen ISO 3166-1 alpha-3 -koodi. Kolmikirjaimisesta muodosta voi olla hyötyä kansainvälisissä tietoaineistoissa, joissa pidempää ja tunnistettavampaa lyhennettä suositaan tai joissa käyttöliittymä edellyttää nimenomaisesti alpha-3-arvoja.

Esimerkiksi API voi määrittää erilliset kentät arvoille country_alpha2 ja country_alpha3. Tällöin HK kuuluu ensimmäiseen kenttään ja HKG toiseen. HKG:n ei pidä automaattisesti korvata HK:ta järjestelmässä, joka tarkistaa vain kaksikirjaimiset arvot.

HKG:tä käytetään myös olympiayhteyksissä. Yhtenevät kirjaimet voivat helpottaa tiedonsiirtoa, mutta olympiakoodit ja ISO-koodit ovat eri organisaatioiden hallinnoimia. Tietueita yhdistettäessä säilytä kentän nimi tai lähdestandardi, jotta HKG:n merkitys pysyy selvänä.

ISO-numeerinen koodi: 344

344 on Hongkongin ISO 3166-1 -numeerinen koodi. Numeeriset tunnisteet ovat hyödyllisiä tilastojärjestelmissä, vanhoissa tietokannoissa ja käyttöliittymissä, joissa tarvitaan kielestä riippumaton arvo ilman kirjainlyhenteitä.

Kenttä nimeltä country_numeric tai iso_numeric voi siis sisältää arvon 344, kun se on määritelty ISO 3166-1:n maantieteelliseksi arvoksi. Se, tallentaako sovellus arvon tekstinä vai numerona, riippuu palveluntarjoajan skeemasta. Säilytä kentän määritelmä ja standardin nimi tietoja siirrettäessä.

Numero 344 voi esiintyä myös muissa järjestelmissä, kuten valuuttatiedoissa. Tämä ei tee tietueista keskenään vaihdettavia. Käytä ilmausta maantieteellinen numeerinen koodi verratessasi ISO-maan arvoa numeeriseen valuutta-arvoon ja pidä molemmat merkitykset erillisissä tyypitetyissä kentissä.

Miten muut Hongkongin tunnisteet eroavat ISO-koodeista

Hongkongin muut tutut koodit ovat hyödyllisiä, mutta ne vastaavat eri kysymyksiin. Puhelinjärjestelmä tarvitsee puhelusuuntanumeron, maksujärjestelmä valuuttakoodin, urheilutietokanta mahdollisesti olympiakoodin ja internet verkkotunnuksen nimen.

Kansainvälinen puhelusuuntanumero: +852

+852 on Hongkongin kansainvälinen puhelusuuntanumero. Se kuuluu televiestinnän numerointijärjestelmään eikä ole ISO 3166-1 -maantunniste. Puhelinsovellus voi käyttää sitä kansainvälisen numeron reitittämiseen tai näyttämiseen, kun taas saman asiakastietueen maakentässä voidaan käyttää HK:ta.

Yhteystietue voisi esimerkiksi sisältää arvot country_iso_alpha2 = HK ja telephone_calling_code = +852. Nämä arvot kuvaavat toisiinsa liittyviä sijaintitietoja, mutta niitä ei pidä tallentaa yhteen erittelemättömään maakoodikenttään. Communications Authority tarjoaa televiestinnän käyttöön Hongkongin numerointisuunnitelmaa koskevia tietoja.

Kun lomakkeessa lukee Hongkongin maakoodi, lue ympäröivät kenttien nimet tarkasti. Jos kenttä liittyy puhelinnumeroon, odotettu arvo voi olla +852. Jos siinä lukee ISO alpha-2, oikea arvo on HK. Tallenna +852 puhelusuuntanumeroa varten tarkoitettuun kenttään, älä ISO-maakoodikenttään.

Valuuttakoodi: HKD

HKD on Hongkongin dollarin ISO 4217 -aakkosellinen koodi. Se yksilöi valuutan, ei maantieteellistä sijaintia. Siksi HKD eroaa sekä HK:sta että HKG:stä, vaikka kaikki kolme sisältävät Hongkongiin liittyviä kirjaimia.

Maksu-, lasku- tai kirjanpitotietue voisi erotella arvot seuraavasti:

  • country_alpha2: HK
  • currency: HKD
  • amount: 1,250.00

Maantieteellinen ISO-numeerinen koodi on 344. Valuuttatietoaineisto voi liittää numerokoodin 344 myös Hongkongin dollariin. Toistuva numero voi aiheuttaa tietovirheitä erityisesti silloin, kun maa- ja valuuttatauluja yhdistetään automaattisesti. Pidä HKD ja maantieteellinen numeerinen koodi 344 erillisissä tyypitetyissä kentissä, vaikka molemmat järjestelmät käyttäisivät numeroa 344.

HKD ei siis ole vaihtoehto ISO 3166-1 -maakoodille. Käytä HKD:tä varten rahoituspalveluntarjoajan dokumentoimaa valuuttakenttää ja HK:ta, HKG:tä tai 344:ää varten asiaankuuluvaa maantieteellistä kenttää.

Olympiakoodi: HKG

Kansainvälinen olympiakomitea käyttää HKG -koodia Hongkongin urheilukoodijärjestelmässä. Se on hyödyllinen luettaessa olympiatuloksia, mitalitaulukoita, joukkueluetteloita tai IOC-lyhenteitä käyttäviä urheilusyötteitä.

Preview image for the video "Cheung Ka Long tekee USKOMATTOMAN paluun maailmanmestaruuskilpailuissa".
Cheung Ka Long tekee USKOMATTOMAN paluun maailmanmestaruuskilpailuissa

Arvo vastaa Hongkongin ISO alpha-3 -koodia, mutta tämä vastaavuus ei tarkoita, että jokainen urheilukoodi olisi ISO-koodi. Merkitys määräytyy tietoaineiston ja sen määrittävän organisaation perusteella. Yleinen maatietokanta voi tulkita HKG:n ISO 3166-1 alpha-3 -koodiksi, kun taas olympiatulostiedosto voi tulkita sen IOC:n urheilukoodiksi.

Kun yhdistät urheilutietoja yleiseen maatietokantaan, säilytä lähdejärjestelmä tai standardin nimi. Käsittele samaa arvoa yhteentoimivuutta helpottavana seikkana, ei todisteena siitä, että koodijärjestelmät ovat identtiset.

Internet-verkkotunnukset: .hk ja .香港

.hk on Hongkongin latinalaista kirjaimistoa käyttävä maatunnukseen perustuva ylätason verkkotunnus. Sitä käytetään DNS:ssä ja internetosoitteissa, ei ISO-maakentän arvona. Sen suhde ISO alpha-2 -arvoon HK auttaa tunnistamaan verkkotunnuksen edustaman alueen, mutta tunnisteilla on silti eri tekniset käyttötarkoitukset.

Preview image for the video "DNS-asetusten muuttaminen HKDNR-verkkotunnuksille (.com.hk JA .hk)".
DNS-asetusten muuttaminen HKDNR-verkkotunnuksille (.com.hk JA .hk)

.香港 on Hongkongia edustava kiinalaista kirjaimistoa käyttävä kansainvälistetty maatunnukseen perustuva ylätason verkkotunnus. Raportti lähteestä IANA dokumentoi sen delegoinnin Hong Kong Internet Registration Corporation Limitedille.

IANA:n IANA delegointitiedot .hk-verkkotunnuksesta nimeävät Hong Kong Internet Registration Corporationin sen maatunnukseen perustuvan ylätason verkkotunnuksen ylläpitäjäksi. Käytännössä verkkotunnuksen rekisteröintiin ja DNS-validointiin voi liittyä sääntöjä, jotka ovat erillisiä ISO-maakoodin tarkistuksesta.

Verkkotunnusohjelmistoissa .香港 on kansainvälistetty nimike. Selain tai DNS-kirjasto voi näyttää käyttäjälle kiinalaista kirjaimistoa käyttävän muodon ja käsitellä samalla sisäisesti ASCII-yhteensopivaa esitysmuotoa. Käytä kyseisen verkkotunnus-API:n edellyttämää muotoa. Ennen kuin toteutat .hk- tai .香港-verkkotunnusten validointi- tai rekisteröintisääntöjä, tarkista ajantasaiset IANA-tiedot ja Hong Kong Internet Registration Corporationin voimassa olevat vaatimukset.

Hongkongin koodien käyttö lomakkeissa, ohjelmistoissa ja tiedoissa

Koodivirheitä syntyy yleensä, kun kenttä on nimetty liian yleisesti. Luotettava integraatio tunnistaa ensin standardin ja muodon ja tarkistaa sen jälkeen arvon tätä määritelmää vasten.

Lomakkeet, tietokannat ja API:t

Käytä HK:ta vain, kun lomake, API tai tietokantakenttä odottaa nimenomaisesti ISO 3166-1 alpha-2 -arvoa. Jos määrityksessä sanotaan alpha-3, käytä arvoa HKG. Jos siinä sanotaan ISO-numeerinen, käytä arvoa 344. Yhden muodon hyväksyvä palvelu voi hylätä muut tai tulkita ne huomaamatta väärin.

Preview image for the video "Esittely | Hei, ristiviittaus – Osa 1".
Esittely | Hei, ristiviittaus – Osa 1

Useita muotoja vaihtava sovellus voi tallentaa erillisiä määritteitä tai käyttää hallittua hakutaulukkoa. Käännösystävällinen esimerkki on:

  • country_alpha2: HK
  • country_alpha3: HKG
  • country_numeric: 344

Erilliset määritteet tekevät muunnoksista yksiselitteisiä. Ne myös estävät kehittäjää sijoittamasta kolmikirjaimista arvoa kaksikirjaimiseen kenttään vain siksi, että molemmat kuvaavat Hongkongia. Jos palveluntarjoaja käyttää yhtä country-nimistä kenttää, tarkista dokumentaatiosta, hyväksyykö se ISO-koodin, näyttönimen vai muun tunnisteen.

Käytä vastaanottavan palvelun määrittämää kirjainkokoa ja tietotyyppiä. ISO:n aakkoselliset koodit esitetään yleensä suuraakkosin, mutta API voi soveltaa omia validointisääntöjään. Numeerinen 344 voidaan esittää tekstinä tai kokonaislukuna. Hallitun hakutaulukon tulee sisältää koodityyppi, lähdestandardi, hyväksytty muoto sekä integraation tarvitsemat versio- tai voimaantulopäivätiedot.

Ennen kuin lähetät Hongkongia koskevan arvon, varmista, odottaako ulkoinen lomake tai API ISO alpha-2-, alpha-3- vai numeerista muotoa. Älä päättele vaadittua esitysmuotoa pelkistä sanoista maakoodi.

Maksut ja talousraportointi

Maksu- ja raportointijärjestelmät tarvitsevat usein sekä maantieteellisiä että rahataloudellisia tietoja. Pidä ne erillään: asiakas tai tapahtuma voi käyttää HK:ta ISO alpha-2 -maantunnisteena ja HKD:tä valuutta-arvona. Toinen järjestelmä voi sen sijaan pyytää HKG:tä tai maantieteellistä numeerista arvoa 344.

Tapahtumatietue voisi esimerkiksi sisältää arvot billing_country = HK, settlement_currency = HKD, ja currency_amount = 500.00. Tarkat kenttien nimet ja hyväksytyt koodit riippuvat maksupalvelusta, pankista, kirjanpitoalustasta tai raportointimäärityksestä.

Numeerinen 344 vaatii erityistä huolellisuutta, kun maa-, tilasto- ja valuuttatietoaineistoja yhdistetään. Säilytä yhdistämisessä alkuperäinen standardi, kuten ISO 3166-1:n maantieteellinen numeerinen koodi tai ISO 4217:n numeerinen valuuttakoodi. Näin toistuva arvo ei synnytä virheellistä merkitysvastaavuutta ja tulos on helpompi selittää täsmäytyksessä tai tarkastuksessa.

Puhelin-, verkkotunnus-, maa- ja valuuttakenttien pitäminen erillään

Hongkongia koskeva yhteysprofiili voi sisältää useita kelvollisia tunnisteita samanaikaisesti:

Preview image for the video "Node.js-projekti kaikkien maailman maiden, osavaltioiden ja kaupunkien luettelon hakemiseen JavaScript-komentorivillä".
Node.js-projekti kaikkien maailman maiden, osavaltioiden ja kaupunkien luettelon hakemiseen JavaScript-komentorivillä
  • iso_country_alpha2: HK
  • iso_country_alpha3: HKG
  • iso_country_numeric: 344
  • telephone_calling_code: +852
  • currency_code: HKD
  • country_code_top_level_domain: .hk

Nämä eivät ole saman koodin keskenään vaihdettavia versioita. Ne tukevat eri tehtäviä: maan tunnistamista, puhelujen reititystä, rahaliikennettä ja verkkotunnusten nimeämistä. Niiden erottelu parantaa validointia, hakua, käyttöliittymien nimikkeitä ja API-yhteentoimivuutta.

Lopullisessa validointivaiheessa jokainen kenttä tulee tarkistaa vastaanottavan palvelun edellyttämää standardia vasten. Tarkista esimerkiksi HK ISO alpha-2 -säännöllä, +852 puhelinsäännöllä, HKD valuuttasäännöllä ja .hk verkkotunnussäännöllä. Kenttäkohtainen lähestymistapa on luotettavampi kuin yhden yleisen maakoodin tarkistimen käyttäminen kaikille arvoille.

Hongkong, Kiina ja virallinen nimeämiskonteksti

Eri kansainväliset standardit, organisaatiot ja ohjelmistopalveluntarjoajat voivat käyttää samasta tarkoitetusta Hongkongin kohteesta erilaisia englanninkielisiä nimikkeitä. Tietoaineistossa voi esiintyä Hong Kong, Hong Kong, China, tai muotoilu, jossa Hongkong määritellään Kiinan erityishallintoalueeksi.

Käytä koodijoukkoa ja virallista nimikettä yhdessä

Nimierot tulee tulkita lähdejärjestelmän kontekstissa. Nimi kertoo, miten lähde kuvaa kohdetta, kun taas HK, HKG tai 344 ilmaisee kyseisessä järjestelmässä käytetyn koodiarvon ja muodon. Nimen vaihtelu ei muuta alpha-2-koodia alpha-3-koodiksi eikä tee maantieteellisestä koodista valuutta- tai puhelinkoodia.

Kun yhdistät tietoaineistoja, säilytä lähdenimi, koodityyppi ja yhdistämissääntö. Tämä on tärkeää osoitetietokannoissa, tilastoissa, maksuissa, toimituksissa ja raportointijärjestelmissä. Älä korvaa lähteen Hongkong-merkintää yleisellä maan nimellä tai yhdistä sitä automaattisesti toiseen merkintään vain siksi, että näyttönimi vaikuttaa samankaltaiselta.

Ajantasaisissa integraatioissa asiaankuuluvat ISO 3166-1 -arvot ovat HK, HKG, ja 344. Entistä nimeä tai käytöstä poistettua koodia tulee käyttää vain, jos dokumentoitu historiallinen tietoaineisto sitä nimenomaisesti edellyttää. Tavallisissa nykyisissä lomakkeissa ja API:issa käytä järjestelmän pyytämää muotoa ja säilytä lähdenimi tietueita vaihdettaessa.

Hongkongin ISO-koodien tärkeimmät kohdat

  • HK on Hongkongin ISO 3166-1 alpha-2 -koodi.
  • HKG on Hongkongin ISO 3166-1 alpha-3 -koodi, ja se esiintyy myös olympialaisten urheilutiedoissa.
  • 344 on Hongkongin ISO 3166-1:n maantieteellinen numeerinen koodi.
  • +852 on kansainvälinen puhelusuuntanumero.
  • HKD on Hongkongin dollarin valuuttakoodi.
  • .hk ja .香港 ovat Hongkongin maatunnukseen perustuvia ylätason verkkotunnuksia.

Valitse arvo kentän dokumentoidun standardin perusteella, älä yleisen ilmauksen Hongkongin maakoodi perusteella. Kun maa-, puhelin-, valuutta-, urheilu- ja verkkotunnustunnisteet pidetään erillisissä kentissä, Hongkongia koskevat tiedot on helpompi validoida ja vaihtaa täsmällisesti.

Valitse alue