Kódy ISO Hongkongu: vysvetlenie HK, HKG a 344

Hľadanie kódu ISO Hongkongu môže priniesť viacero rôznych odpovedí, pretože krajinské, telefónne, menové, športové a internetové systémy používajú samostatné identifikátory. Kódy ISO 3166-1 Hongkongu sú HK, HKG a 344. Táto príručka vysvetľuje význam jednotlivých formátov, dôvod, prečo sa HKG môže objaviť aj v olympijských údajoch, a spôsob, ako vo formulároch, softvéri a finančných záznamoch odlíšiť kódy ISO od +852, HKD, .hk a .香港.

Kódy ISO Hongkongu: stručná odpoveď

Hongkong má tri reprezentácie podľa ISO 3166-1: dvojpísmenový kód alfa-2, trojpísmenový kód alfa-3 a číselný kód. Správna hodnota závisí od poľa alebo systému, ktorý údaje prijíma.

Tri kódy ISO 3166-1 v jednom prehľade

Sekundárny zoznam krajín ISO od Docebo Help & Support tiež identifikuje Hongkong hodnotou alfa-2 HK. Telefónny smerový kód, menový kód, olympijský kód a internetové domény nie sú ďalšími formátmi ISO 3166-1. Patria k iným normám alebo organizáciám.

Vysvetlenie troch kódov ISO 3166-1 Hongkongu

Tri formáty ISO predstavujú ten istý geografický záznam rôznymi spôsobmi. Nie sú zameniteľné v každej aplikácii, preto by dokumentácia prijímajúceho systému mala určiť, ktorú hodnotu máte odoslať alebo uložiť.

Kód ISO alfa-2: HK

HK je dvojpísmenový identifikátor Hongkongu podľa ISO 3166-1 alfa-2. Ide o kompaktný formát, ktorý sa najčastejšie vyžaduje, keď všeobecné krajinské pole požaduje hodnotu ISO alfa-2. Databáza navrhnutá pre túto normu môže napríklad ukladať country_alpha2 = HK.

HK nie je to isté ako medzinárodná telefónna predvoľba +852. Rovnako nie je totožné s koncovkou domény .hk, hoci tieto písmená spolu súvisia. Prvá hodnota je krajinský údaj ISO, druhá sa používa v telefónnom číslovaní a tretia je identifikátor DNS.

HK používajte vtedy, keď formulár, API alebo špecifikácia údajov jasne uvádza, že očakáva ISO 3166-1 alfa-2. Nepredpokladajte, že každé pole označené ako kód krajiny používa tento formát. Niektoré služby vyžadujú úplný názov, hodnotu alfa-3, číselnú hodnotu alebo kód špecifický pre poskytovateľa.

Kód ISO alfa-3: HKG

HKG je trojpísmenový kód Hongkongu podľa ISO 3166-1 alfa-3. Trojpísmenový formát môže byť užitočný v medzinárodných súboroch údajov, kde sa uprednostňuje dlhšia a rozpoznateľnejšia skratka alebo kde rozhranie výslovne vyžaduje hodnoty alfa-3.

API môže napríklad definovať samostatné polia pre country_alpha2 a country_alpha3. V takej situácii patrí HK do prvého poľa a HKG do druhého. HKG by nemalo automaticky nahrádzať HK v systéme, ktorý overuje iba dvojpísmenové hodnoty.

HKG sa používa aj v olympijskom kontexte. Zhodné písmená môžu uľahčiť výmenu údajov, olympijský kód a kód ISO však spravujú rôzne organizácie. Pri mapovaní záznamov zachovajte názov poľa alebo zdrojovej normy, aby význam HKG zostal jasný.

Číselný kód ISO: 344

344 je číselný kód Hongkongu podľa ISO 3166-1. Číselné identifikátory sú užitočné v štatistických systémoch, starších databázach a rozhraniach, ktoré potrebujú jazykovo neutrálnu hodnotu bez abecedných skratiek.

Pole s názvom country_numeric alebo iso_numeric preto môže obsahovať 344, ak je definované ako geografická hodnota ISO 3166-1. To, či aplikácia uloží hodnotu ako text alebo číslo, závisí od schémy poskytovateľa. Pri výmene údajov zachovajte definíciu poľa a názov normy.

Číslo 344 sa môže vyskytovať aj v iných systémoch vrátane menových údajov. To neznamená, že záznamy sú zameniteľné. Pri porovnávaní hodnoty krajiny ISO s číselnou menovou hodnotou používajte výraz geografický číselný kód a oba významy uchovávajte v samostatných typovaných poliach.

Ako sa ostatné identifikátory Hongkongu líšia od kódov ISO

Ostatné známe kódy Hongkongu sú užitočné, odpovedajú však na iné otázky. Telefónny systém potrebuje smerový kód, platobný systém menový kód, športová databáza môže potrebovať olympijský kód a internet potrebuje označenie domény.

Medzinárodný telefónny smerový kód: +852

+852 je medzinárodný telefónny smerový kód Hongkongu. Je súčasťou telekomunikačného číslovacieho systému, nie identifikátorom krajiny podľa ISO 3166-1. Telefónna aplikácia ho môže používať na smerovanie alebo zobrazovanie medzinárodného čísla, zatiaľ čo krajinské pole v tom istom zákazníckom zázname môže používať HK.

Záznam o pripojení môže napríklad obsahovať country_iso_alpha2 = HK a telephone_calling_code = +852. Tieto hodnoty opisujú súvisiace informácie o lokalite, nemali by sa však ukladať do jedného nerozlíšeného poľa kódu krajiny. Informácie o hongkonskom číslovacom pláne pre telekomunikačné použitie poskytuje Office of the Communications Authority .

Keď formulár uvádza hongkonský kód krajiny, pozorne si prečítajte okolité označenia polí. Ak pole patrí k telefónnemu číslu, môže sa očakávať +852. Ak uvádza ISO alfa-2, relevantnou hodnotou je HK. +852 ukladajte do poľa telefónneho smerového kódu, nie do poľa kódu krajiny ISO.

Menový kód: HKD

HKD je abecedný kód hongkonského dolára podľa ISO 4217. Identifikuje menu, nie geografickú lokalitu. Preto sa HKD líši od HK aj HKG, hoci všetky tri obsahujú písmená spojené s Hongkongom.

Pokladničný, fakturačný alebo účtovný záznam môže tieto hodnoty oddeľovať takto:

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

Geografický číselný kód ISO je 344. Menový súbor údajov môže tiež spájať číslo 344 s hongkonským dolárom ako číselným menovým kódom. Opakujúce sa číslo môže byť zdrojom chýb údajov, najmä pri automatickom spájaní krajinských a menových tabuliek. HKD a geografický číselný kód 344 uchovávajte v samostatných typovaných poliach, aj keď oba systémy používajú číslo 344.

HKD preto nie je alternatívou ku kódu krajiny podľa ISO 3166-1. HKD používajte v zdokumentovanom menovom poli finančného poskytovateľa a HK, HKG alebo 344 v príslušnom geografickom poli.

Olympijský kód: HKG

Medzinárodný olympijský výbor používa HKG vo svojom systéme športových kódov pre Hongkong. Je to užitočné pri čítaní olympijských výsledkov, medailových tabuliek, zoznamov tímov alebo športových kanálov používajúcich skratky MOV.

Cheung Ka Long predvádza NEUVERITEĽNÝ NÁVRAT na majstrovstvách sveta

Hodnota sa zhoduje s kódom Hongkongu ISO alfa-3, táto zhoda však neznamená, že každý športový kód je kódom ISO. Význam vyplýva zo súboru údajov a organizácie, ktorá ho definuje. Všeobecná krajinská databáza môže HKG interpretovať ako ISO 3166-1 alfa-3, zatiaľ čo súbor olympijských výsledkov ako športový kód MOV.

Pri mapovaní športových údajov do všeobecnej krajinskej databázy zachovajte zdrojový systém alebo názov normy. Zhodnú hodnotu považujte za prostriedok interoperability, nie za dôkaz, že oba kódové systémy sú totožné.

Internetové domény: .hk a .香港

.hk je doména najvyššej úrovne s kódom krajiny Hongkongu v latinke. Používa sa v DNS a internetových adresách, nie ako hodnota poľa krajiny ISO. Jej vzťah k hodnote ISO alfa-2 HK pomáha identifikovať územie reprezentované doménou, oba identifikátory však naďalej slúžia na odlišné technické účely.

Zmena DNS pre domény HKDNR (.com.hk A .hk)

.香港 je internacionalizovaná doména najvyššej úrovne s kódom krajiny v čínskom písme, ktorá predstavuje Hongkong. Správa o delegovaní od IANA dokumentuje jej delegovanie spoločnosti Hong Kong Internet Registration Corporation Limited.

Údaje o delegovaní domény .hk od IANA uvádzajú Hong Kong Internet Registration Corporation ako správcu tejto domény najvyššej úrovne s kódom krajiny. Registrácia domén a overovanie DNS môžu v praxi podliehať pravidlám oddeleným od overovania kódov krajín ISO.

V doménovom softvéri je .香港 internacionalizované označenie. Prehliadač alebo knižnica DNS môže zobrazovať používateľovi čínsku podobu, pričom interne spracúva reprezentáciu kompatibilnú s ASCII. Používajte formát vyžadovaný konkrétnym doménovým API. Pred implementáciou pravidiel overovania alebo registrácie pre .hk či .香港 si overte aktuálne informácie IANA a aktuálne požiadavky Hong Kong Internet Registration Corporation.

Používanie kódov Hongkongu vo formulároch, softvéri a údajoch

Chyby kódov zvyčajne vznikajú vtedy, keď je pole pomenované príliš všeobecne. Spoľahlivá integrácia najprv určí normu a formát a potom hodnotu overí podľa tejto definície.

Formuláre, databázy a API

Používajte HK iba vtedy, keď formulár, API alebo databázové pole výslovne očakáva ISO 3166-1 alfa-2. Ak špecifikácia uvádza alfa-3, použite HKG. Ak uvádza ISO numerický formát, použite 344. Služba, ktorá prijíma jeden formát, môže ostatné odmietnuť alebo ich potichu nesprávne interpretovať.

Ukážka | Ahoj, krížová referencia – 1. časť

Aplikácia, ktorá vymieňa viacero formátov, môže ukladať samostatné atribúty alebo používať riadenú vyhľadávaciu tabuľku. Príklad vhodný na preklad je:

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

Samostatné atribúty robia transformácie explicitnými. Zároveň bránia vývojárovi vložiť trojpísmenovú hodnotu do dvojpísmenového poľa len preto, že obe opisujú Hongkong. Ak poskytovateľ používa jediné pole s názvom country, prečítajte si jeho dokumentáciu a zistite, či prijíma kód ISO, zobrazovaný názov alebo iný identifikátor.

Používajte veľkosť písmen a dátový typ určené prijímajúcou službou. Abecedné kódy ISO sa bežne uvádzajú veľkými písmenami, API však môže uplatňovať vlastné pravidlá overovania. Číslo 344 môže byť reprezentované ako text alebo celé číslo. Riadená vyhľadávacia tabuľka by mala zaznamenávať typ kódu, zdrojovú normu, prijímaný formát a všetky informácie o verzii alebo dátume účinnosti potrebné pre integráciu.

Pred odoslaním hodnoty pre Hongkong overte, či externý formulár alebo API očakáva formát ISO alfa-2, alfa-3 alebo numerický formát. Požadovanú reprezentáciu neodvodzujte iba zo slov kód krajiny.

Platby a finančné vykazovanie

Platobné a vykazovacie systémy často potrebujú geografické aj menové informácie. Uchovávajte ich oddelene: zákazník alebo transakcia môže používať HK ako hodnotu krajiny ISO alfa-2 a HKD ako menovú hodnotu. Iný systém môže namiesto toho vyžadovať HKG alebo geografické číslo 344.

Transakčný záznam môže napríklad obsahovať billing_country = HK, settlement_currency = HKD, a currency_amount = 500.00. Presné názvy polí a prijímané kódy závisia od platobnej služby, banky, účtovnej platformy alebo vykazovacej špecifikácie.

Pri kombinovaní krajinských, štatistických a menových súborov údajov si číselné číslo 344 vyžaduje osobitnú pozornosť. V mapovaní zachovajte pôvodnú normu, napríklad geografické číslo ISO 3166-1 alebo menové číslo ISO 4217. Tým zabránite tomu, aby opakovaná hodnota vytvorila falošnú sémantickú zhodu, a uľahčíte vysvetlenie výsledku pri zosúlaďovaní alebo audite.

Oddelenie telefónnych, doménových, krajinských a menových polí

Profil pripojenia pre Hongkong môže obsahovať viacero platných identifikátorov súčasne:

Node.js projekt na získanie zoznamu všetkých krajín, štátov a miest na svete v príkazovom riadku pomocou JavaScriptu

• 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

Tieto hodnoty nie sú vzájomne zameniteľnými verziami jedného kódu. Podporujú rôzne úlohy: identifikáciu krajiny, telefónne smerovanie, spracovanie peňazí a pomenovanie domény. Ich oddelenie zlepšuje overovanie, vyhľadávanie, označenia používateľského rozhrania a interoperabilitu API.

Záverečný krok overovania by mal kontrolovať každé pole podľa normy očakávanej prijímajúcou službou. HK napríklad overujte pravidlom ISO alfa-2, +852 telefónnym pravidlom, HKD menovým pravidlom a .hk doménovým pravidlom. Tento prístup po jednotlivých poliach je spoľahlivejší než použitie jedného všeobecného validátora kódov krajín na každú hodnotu.

Hongkong, Čína a kontext oficiálneho pomenovania

Rôzne medzinárodné normy, organizácie a poskytovatelia softvéru môžu pre ten istý zamýšľaný záznam Hongkongu používať rôzne anglické označenia. Súbor údajov môže uvádzať Hong Kong, Hong Kong, China, alebo formuláciu, ktorá označuje Hongkong ako osobitnú administratívnu oblasť Číny.

Kódovú sadu používajte spolu s oficiálnym označením

Rozdiely v názvoch treba interpretovať v kontexte zdrojového systému. Označenie ukazuje, ako zdroj opisuje záznam, zatiaľ čo HK, HKG alebo 344 identifikuje hodnotu kódu a formát používaný v tomto systéme. Zmena názvu nepremení kód alfa-2 na alfa-3 ani z geografického kódu neurobí menový či telefónny kód.

Pri kombinovaní súborov údajov zachovajte zdrojové označenie, typ kódu a pravidlo agregácie. Je to dôležité pre adresné databázy, štatistiky, platby, prepravu a vykazovacie systémy. Nenahrádzajte záznam Hongkongu zo zdroja všeobecným názvom krajiny ani ho automaticky nespájajte s iným záznamom len preto, že zobrazovaný názov vyzerá podobne.

Pre aktuálne integrácie sú relevantné hodnoty ISO 3166-1 HK, HKG, a 344. Bývalý názov alebo vyradený kód používajte iba vtedy, keď ho výslovne vyžaduje zdokumentovaný historický súbor údajov. V bežných aktuálnych formulároch a API používajte formát požadovaný systémom a pri výmene záznamov zachovajte zdrojové označenie.

Hlavné závery o kódoch ISO Hongkongu

• HK je kód Hongkongu ISO 3166-1 alfa-2.
• HKG je kód Hongkongu ISO 3166-1 alfa-3 a objavuje sa aj v olympijských športových údajoch.
• 344 je geografický číselný kód Hongkongu podľa ISO 3166-1.
• +852 je medzinárodný telefónny smerový kód.
• HKD je menový kód hongkonského dolára.
• .hk a .香港 sú domény najvyššej úrovne s kódom krajiny Hongkongu.

Hodnotu vyberajte podľa zdokumentovanej normy poľa, nie podľa všeobecnej frázy hongkonský kód krajiny. Uchovávanie krajinských, telefónnych, menových, športových a doménových identifikátorov v samostatných poliach uľahčuje presné overovanie a výmenu údajov o Hongkongu.