Hongkong ISO-kódjai: a HK, a HKG és a 344 magyarázata

A Hongkong ISO-kódjára keresve többféle válaszba ütközhetünk, mivel az ország-, telefon-, valuta-, sport- és internetrendszerek külön azonosítókat használnak. Hongkong ISO 3166-1-kódjai: HK, HKG és 344. Ez az útmutató elmagyarázza, mit jelent az egyes formátumok használata, miért jelenhet meg a HKG olimpiai adatokban is, valamint hogyan különíthetők el az ISO-kódok a +852-től, a HKD-től, a .hk-tól és a .香港-tól űrlapokban, szoftverekben és pénzügyi nyilvántartásokban.

Hongkong ISO-kódjai: gyors válasz

Hongkongnak három ISO 3166-1-ábrázolása van: a kétbetűs alfa-2-kód, a hárombetűs alfa-3-kód és a numerikus kód. A megfelelő érték attól a mezőtől vagy rendszertől függ, amely fogadja az adatot.

A három ISO 3166-1-kód egyetlen áttekintésben

A másodlagos ISO-országlista innen: Docebo Help & Support szintén a HK alfa-2-értékkel azonosítja Hongkongot. A telefonos hívókód, a pénznemkód, az olimpiai kód és az internetes domainek nem további ISO 3166-1-formátumok. Ezek más szabványokhoz vagy szervezetekhez tartoznak.

A három hongkongi ISO 3166-1-kód magyarázata

A három ISO-formátum ugyanazt a földrajzi bejegyzést ábrázolja különböző módokon. Nem minden alkalmazásban felcserélhetők, ezért a fogadó rendszer dokumentációja alapján kell meghatározni, melyik értéket küldjük vagy tároljuk.

Az ISO alfa-2-kód: HK

HK Hongkong kétbetűs ISO 3166-1 alfa-2-azonosítója. Ez a leggyakrabban kért tömör forma, amikor egy általános országmező ISO alfa-2-értéket vár. Például egy erre a szabványra tervezett adatbázis a következőt tárolhatja: country_alpha2 = HK.

A HK nem azonos a nemzetközi telefonos előhívóval: +852. Nem azonos a domainvégződéssel sem: .hk, még ha a betűk kapcsolatban állnak is egymással. Az első ISO-országérték, a másodikat a telefonos számozásban, a harmadikat pedig DNS-azonosítóként használják.

A HK-t akkor használja, ha az űrlap, az API vagy az adatspecifikáció egyértelműen jelzi, hogy ISO 3166-1 alfa-2-kódot vár. Ne feltételezze, hogy minden „országkód” feliratú mező ezt a formátumot használja. Egyes szolgáltatások teljes nevet, alfa-3-értéket, numerikus értéket vagy szolgáltatóspecifikus kódot igényelnek.

Az ISO alfa-3-kód: HKG

HKG Hongkong hárombetűs ISO 3166-1 alfa-3-kódja. A hárombetűs forma hasznos lehet olyan nemzetközi adatkészletekben, amelyekben a hosszabb, könnyebben felismerhető rövidítést részesítik előnyben, vagy ahol a felület kifejezetten alfa-3-értékeket igényel.

Egy API például külön mezőket határozhat meg a következőkhöz: country_alpha2 és country_alpha3. Ebben az esetben az első mezőbe HK, a másodikba pedig HKG kerül. A HKG nem helyettesítheti automatikusan a HK-t olyan rendszerben, amely csak kétbetűs értékeket ellenőriz.

A HKG-t olimpiai környezetben is használják. Az egyező betűk megkönnyíthetik az adatcserét, de az olimpiai kódot és az ISO-kódot különböző szervezetek szabályozzák. A rekordok leképezésekor őrizze meg a mező nevét vagy a forrásszabványt, hogy a HKG jelentése egyértelmű maradjon.

Az ISO numerikus kód: 344

344 Hongkong ISO 3166-1 numerikus kódja. A numerikus azonosítók hasznosak statisztikai rendszerekben, régebbi adatbázisokban és olyan felületeken, amelyek nyelvfüggetlen, alfabetikus rövidítések nélküli értéket igényelnek.

Az alábbi nevű mező: country_numeric vagy iso_numeric ezért a 344-et tartalmazhatja, ha ISO 3166-1 szerinti földrajzi értékként definiálták. Az, hogy az alkalmazás szövegként vagy számként tárolja-e az értéket, a szolgáltató sémájától függ. Adatcsere során őrizze meg a mező definícióját és a szabvány nevét.

A 344 más rendszerekben, többek között pénznemadatokban is előfordulhat. Ettől a rekordok még nem lesznek felcserélhetők. Az ISO-országérték pénznembeli numerikus értékkel való összehasonlításakor használja a következő kifejezést: földrajzi numerikus kód és mindkét jelentést külön, típusos mezőkben tartsa nyilván.

Miben különböznek Hongkong egyéb azonosítói az ISO-kódoktól?

Hongkong egyéb ismert kódjai hasznosak, de eltérő kérdésekre válaszolnak. A telefonrendszernek hívókódra, a fizetési rendszernek pénznemkódra, a sportadatbázisnak olimpiai kódra, az internetnek pedig domaincímkére lehet szüksége.

A nemzetközi hívókód: +852

+852 Hongkong nemzetközi telefonos hívókódja. A távközlési számozási rendszer része, nem pedig ISO 3166-1 szerinti országazonosító. Egy telefonos alkalmazás az előhívót nemzetközi számok továbbítására vagy megjelenítésére használhatja, miközben ugyanazon ügyfélrekord országmezője a HK-t tartalmazhatja.

Egy kapcsolódási rekord például a következőket tartalmazhatja: country_iso_alpha2 = HK és telephone_calling_code = +852. Ezek az értékek kapcsolódó helyinformációt írnak le, de nem szabad őket egyetlen, nem differenciált országkódmezőben tárolni. A Communications Authority Office távközlési célokra hongkongi számozási tervre vonatkozó információkat biztosít.

Amikor egy űrlap Hongkong országkódját kéri, figyelmesen olvassa el a környező mezőfeliratokat. Ha a mező egy telefonszámhoz tartozik, a +852 lehet az elvárt érték. Ha ISO alfa-2 szerepel rajta, akkor a HK a megfelelő érték. A +852-t telefonos hívókódmezőben tárolja, ne ISO-országkódmezőben.

A pénznemkód: HKD

HKD a hongkongi dollár ISO 4217 szerinti alfabetikus kódja. Pénznemet azonosít, nem földrajzi helyet. Emiatt a HKD különbözik a HK-tól és a HKG-től is, annak ellenére, hogy mindhárom Hongkonghoz kapcsolódó betűket tartalmaz.

Egy pénztár-, számla- vagy könyvelési rekord például így különítheti el az értékeket:

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

A földrajzi ISO numerikus kód 344. Egy pénznemadatkészlet a 344-et a hongkongi dollár numerikus pénznemkódjaként is társíthatja. Az ismétlődő szám potenciális adatforrás-hiba, különösen akkor, ha az ország- és pénznemtáblákat automatikusan kapcsolják össze. A HKD-t és a 344-es földrajzi numerikus kódot külön, típusos mezőkben tartsa nyilván, még akkor is, ha mindkét rendszer a 344-es számot használja.

A HKD tehát nem alternatívája az ISO 3166-1 szerinti országkódnak. A HKD-t a pénzügyi szolgáltató dokumentált pénznemmezőjében, a HK-t, a HKG-t vagy a 344-et pedig a megfelelő földrajzi mezőben használja.

Az olimpiai kód: HKG

A Nemzetközi Olimpiai Bizottság a következőt használja: HKG sportkódrendszerében Hongkonghoz. Ez hasznos olimpiai eredmények, éremtáblázatok, csapatlisták vagy IOC-rövidítéseket használó sportadatfolyamok olvasásakor.

Cheung Ka Long HIHETETLEN VISSZATÉRÉSE a világbajnokságon

Az érték megegyezik Hongkong ISO alfa-3-kódjával, de ez nem jelenti azt, hogy minden sportkód ISO-kód. A jelentést az adatkészlet és az azt meghatározó szervezet adja. Egy általános országadatbázis a HKG-t ISO 3166-1 alfa-3-kódként értelmezheti, míg egy olimpiai eredményfájl IOC-sportkódként.

Amikor sportadatokat képez le egy általános országadatbázisba, őrizze meg a forrásrendszert vagy a szabvány nevét. Az egyező értéket együttműködési kényelmi elemként kezelje, ne annak bizonyítékaként, hogy a két kódrendszer azonos.

Az internetes domainek: .hk és .香港

.hk Hongkong latin betűs országkód szerinti felső szintű domainje. A DNS-ben és internetcímekben használják, nem pedig ISO-országmező értékeként. Az ISO alfa-2-értékkel (HK) való kapcsolata segít azonosítani a domain által képviselt területet, de a két azonosító eltérő technikai célt szolgál.

DNS módosítása HKDNR-domainekhez (.com.hk ÉS .hk)

.香港 Hongkong kínai írásjegyekkel megjelenő, nemzetköziesített országkód szerinti felső szintű domainje. A delegálási jelentés, amelyet az IANA közzétett, dokumentálja a delegálást a Hong Kong Internet Registration Corporation Limited részére.

Az IANA delegálási adatai a .hk esetében a Hong Kong Internet Registration Corporationt jelölik az országkód szerinti felső szintű domain kezelőjeként. A gyakorlatban a domainregisztrációra és a DNS-ellenőrzésre az ISO-országkód-ellenőrzéstől különálló szabályok vonatkozhatnak.

A domainkezelő szoftverben a .香港 nemzetköziesített címke. A böngésző vagy a DNS-könyvtár a felhasználó által látható kínai írásjegyes formát jelenítheti meg, miközben belsőleg ASCII-kompatibilis ábrázolást dolgoz fel. A konkrét domain-API által megkövetelt formátumot használja. A .hk vagy a .香港 ellenőrzési, illetve regisztrációs szabályainak bevezetése előtt tekintse át az aktuális IANA-információkat és a Hong Kong Internet Registration Corporation aktuális követelményeit.

Hongkongi kódok használata űrlapokban, szoftverekben és adatokban

A kódhibák általában akkor fordulnak elő, amikor egy mező elnevezése túl általános. A megbízható integráció először azonosítja a szabványt és a formátumot, majd az értéket az adott definíció szerint ellenőrzi.

Űrlapok, adatbázisok és API-k

A következőt használja: HK csak akkor, ha egy űrlap, API vagy adatbázismező kifejezetten ISO 3166-1 alfa-2-kódot vár. Ha a specifikáció alfa-3-at ír elő, használja a következőt: HKG. Ha ISO numerikus kódot ír elő, használja a következőt: 344. Az egyik formátumot elfogadó szolgáltatás a többit elutasíthatja, vagy csendben hibásan értelmezheti.

Bemutató | Helló kereszthivatkozás – 1. rész

A többféle formátumot cserélő alkalmazás külön attribútumokat tárolhat, vagy szabályozott keresőtáblát használhat. Egy fordításbarát példa:

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

A külön attribútumok egyértelművé teszik az átalakításokat. Azt is megakadályozzák, hogy egy fejlesztő hárombetűs értéket helyezzen kétbetűs mezőbe pusztán azért, mert mindkettő Hongkongot írja le. Ha egy szolgáltató egyetlen, country nevű mezőt használ, olvassa el a dokumentációját, hogy kiderüljön, ISO-kódot, megjelenítési nevet vagy más azonosítót fogad-e el.

A fogadó szolgáltatás által meghatározott kis- és nagybetűs formátumot, valamint adattípust használja. Az ISO alfabetikus kódokat általában nagybetűvel írják, de egy API saját ellenőrzési szabályokat alkalmazhat. A 344 szövegként vagy egész számként is megjelenhet. A szabályozott keresőtáblának rögzítenie kell a kódtípust, a forrásszabványt, az elfogadott formátumot, valamint az integrációhoz szükséges verzió- vagy hatálybalépési dátumot.

Hongkongi érték elküldése előtt ellenőrizze, hogy a külső űrlap vagy API ISO alfa-2-, alfa-3- vagy numerikus formátumot vár-e. Ne következtesse ki a szükséges ábrázolást pusztán az „országkód” kifejezésből.

Fizetések és pénzügyi jelentések

A fizetési és jelentési rendszereknek gyakran földrajzi és pénzügyi információkra egyaránt szükségük van. Tartsa ezeket külön: egy ügyfél vagy tranzakció a következőt használhatja: HK ISO alfa-2 szerinti országértékként, a következőt pedig: HKD pénznemértékként. Egy másik rendszer ehelyett a HKG-t vagy a 344-es földrajzi numerikus kódot kérheti.

Egy tranzakciós rekord például a következőket tartalmazhatja: billing_country = HK, settlement_currency = HKD, valamint currency_amount = 500.00. A pontos mezőnevek és az elfogadott kódok a fizetési szolgáltatástól, banktól, könyvelési platformtól vagy jelentési specifikációtól függenek.

A 344 különös figyelmet igényel az ország-, statisztikai és pénznemadatkészletek egyesítésekor. Őrizze meg a leképezésben a kiinduló szabványt, például az ISO 3166-1 szerinti földrajzi numerikus vagy az ISO 4217 szerinti numerikus pénznemkódot. Ez megakadályozza, hogy egy ismétlődő érték hamis szemantikai egyezést hozzon létre, és megkönnyíti az eredmény magyarázatát egyeztetés vagy ellenőrzés során.

A telefon-, domain-, ország- és pénznemmezők elkülönítése

Egy hongkongi kapcsolódási profil egyszerre több érvényes azonosítót is tartalmazhat:

Node.js-projekt a világ összes ország-, állam- és városlistájának lekéréséhez JavaScriptben, parancssorból

• 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

Ezek nem ugyanazon kód felcserélhető változatai. Különböző feladatokat támogatnak: országazonosítást, telefonos továbbítást, pénzügyi feldolgozást és domainnevezést. Elkülönítésük javítja az ellenőrzést, a keresést, a felhasználói felületek feliratait és az API-k közötti együttműködést.

A végső ellenőrzési lépésben minden mezőt a fogadó szolgáltatás által elvárt szabvány szerint kell ellenőrizni. Például a HK-t ISO alfa-2-szabállyal, a +852-t telefonos szabállyal, a HKD-t pénznemszabállyal, a .hk-t pedig domainszabállyal ellenőrizze. Ez a mezőnkénti megközelítés megbízhatóbb annál, mint ha minden értékre egyetlen általános országkód-ellenőrzőt alkalmazna.

Hongkong, Kína és a hivatalos elnevezés kontextusa

A különböző nemzetközi szabványok, szervezetek és szoftverszolgáltatók eltérő angol címkéket használhatnak ugyanahhoz a Hongkong-bejegyzéshez. Egy adatkészlet megjelenítheti a következőt: Hong Kong, Hong Kong, China, vagy olyan megfogalmazást, amely Hongkongot Kína különleges közigazgatási régiójaként azonosítja.

A kódkészletet és a hivatalos címkét együtt használja

A névbeli eltéréseket a forrásrendszer kontextusában kell értelmezni. A címke megmutatja, hogyan írja le a forrás a bejegyzést, míg a HK, a HKG vagy a 344 az adott rendszerben használt kódértéket és formátumot azonosítja. A névváltozat nem változtatja az alfa-2-kódot alfa-3-kóddá, és nem tesz egy földrajzi kódot pénznem- vagy telefonkóddá.

Adatkészletek egyesítésekor őrizze meg a forráscímkét, a kódtípust és az összesítési szabályt. Ez fontos a címadatbázisok, statisztikák, fizetések, szállítási és jelentési rendszerek esetében. Ne cserélje le automatikusan a forrás Hongkong-bejegyzését általános országcímkére, és ne vonja össze egy másik bejegyzéssel pusztán azért, mert a megjelenítési név hasonlónak tűnik.

Az aktuális integrációkhoz a vonatkozó ISO 3166-1-értékek a következők: HK, HKG, valamint 344. Korábbi nevet vagy visszavont kódot csak akkor használjon, ha azt egy dokumentált történeti adatkészlet kifejezetten megköveteli. A jelenlegi szokásos űrlapokhoz és API-khoz a rendszer által kért formátumot használja, és rekordcsere esetén őrizze meg a forráscímkét.

A hongkongi ISO-kódok legfontosabb tanulságai

• HK Hongkong ISO 3166-1 alfa-2-kódja.
• HKG Hongkong ISO 3166-1 alfa-3-kódja, amely olimpiai sportadatokban is megjelenik.
• 344 Hongkong ISO 3166-1 szerinti földrajzi numerikus kódja.
• +852 a nemzetközi telefonos hívókód.
• HKD a hongkongi dollár pénznemkódja.
• .hk és .香港 Hongkong országkód szerinti felső szintű domainjei.

Az értéket a mező dokumentált szabványa alapján válassza, ne az általános „Hongkong országkódja” kifejezés alapján. Az ország-, telefon-, pénznem-, sport- és domainazonosítók külön mezőkben tartása megkönnyíti a hongkongi adatok pontos ellenőrzését és cseréjét.