קודי ISO של הונג קונג: הסבר על HK, HKG ו־344

חיפוש אחר קוד ה־ISO של הונג קונג עשוי להוביל לכמה תשובות שונות, משום שמערכות המדינה, הטלפון, המטבע, הספורט והאינטרנט משתמשות במזהים נפרדים. קודי ISO 3166-1 של הונג קונג הם HK, ‏HKG ו־344. מדריך זה מסביר מה המשמעות של כל תבנית, מדוע HKG עשוי להופיע גם בנתונים אולימפיים, וכיצד להפריד בין קודי ISO לבין +852, ‏HKD, ‎.hk ו־.香港 בטפסים, בתוכנות וברשומות פיננסיות.

קודי ISO של הונג קונג: תשובה מהירה

להונג קונג יש שלוש צורות ייצוג לפי ISO 3166-1: קוד אלפביתי בן שתי אותיות, קוד אלפביתי בן שלוש אותיות וקוד מספרי. הערך הנכון תלוי בשדה או במערכת שמקבלים את הנתונים.

שלושת קודי ISO 3166-1 במבט אחד

רשימת מדינות משנית של ISO מאת Docebo Help & Support מזהה גם היא את הונג קונג באמצעות ערך האלפא־2 HK. קוד החיוג הטלפוני, קוד המטבע, הקוד האולימפי וסיומות האינטרנט אינם תבניות נוספות של ISO 3166-1. הם שייכים לתקנים או לארגונים אחרים.

הסבר על שלושת קודי ISO 3166-1 של הונג קונג

שלוש תבניות ה־ISO מייצגות את אותה רשומה גאוגרפית בדרכים שונות. הן אינן ניתנות להחלפה בכל יישום, ולכן התיעוד של המערכת המקבלת צריך לקבוע איזה ערך יש לשלוח או לשמור.

קוד האלפא־2 של ISO: ‏HK

HK הוא המזהה האלפביתי בן שתי האותיות של הונג קונג לפי ISO 3166-1 אלפא־2. זוהי הצורה הקצרה הנדרשת לרוב כאשר שדה מדינה כללי מבקש ערך ISO אלפא־2. לדוגמה, מסד נתונים שתוכנן לתקן זה עשוי לשמור country_alpha2 = HK.

HK אינו זהה לקידומת החיוג הבינלאומית +852. הוא גם אינו זהה לסיומת הדומיין .hk, אף שהאותיות קשורות זו לזו. הראשון הוא ערך מדינה של ISO, השני משמש במספור טלפוני והשלישי הוא מזהה DNS.

השתמשו ב־HK כאשר הטופס, ה־API או מפרט הנתונים מציינים במפורש שהם מצפים ל־ISO 3166-1 אלפא־2. אל תניחו שכל שדה שכותרתו „קוד מדינה” משתמש בתבנית זו. שירותים מסוימים דורשים שם מלא, ערך אלפא־3, ערך מספרי או קוד ייחודי לספק.

קוד האלפא־3 של ISO: ‏HKG

HKG הוא קוד ISO 3166-1 אלפא־3 בן שלוש האותיות של הונג קונג. תבנית בת שלוש אותיות עשויה להיות שימושית במערכי נתונים בינלאומיים שבהם מעדיפים קיצור ארוך ומזוהה יותר, או כאשר הממשק דורש במפורש ערכי אלפא־3.

לדוגמה, API עשוי להגדיר שדות נפרדים עבור country_alpha2 ו־ country_alpha3. במקרה כזה, HK שייך לשדה הראשון ו־HKG לשני. אין להחליף אוטומטית את HK ב־HKG במערכת שמאמתת ערכים בני שתי אותיות בלבד.

HKG משמש גם בהקשרים אולימפיים. ההתאמה בין האותיות עשויה להקל על החלפת נתונים, אך קוד אולימפי וקוד ISO מנוהלים בידי ארגונים שונים. בעת מיפוי רשומות, שמרו את שם השדה או את תקן המקור כדי שמשמעותו של HKG תישאר ברורה.

הקוד המספרי של ISO: ‏344

344 הוא הקוד המספרי של הונג קונג לפי ISO 3166-1. מזהים מספריים שימושיים במערכות סטטיסטיות, במסדי נתונים ישנים ובממשקים הזקוקים לערך שאינו תלוי בשפה וללא קיצורים אלפביתיים.

שדה בשם country_numeric או iso_numeric יכול לכן להכיל 344 כאשר הוא מוגדר כערך גאוגרפי לפי ISO 3166-1. אם היישום שומר את הערך כטקסט או כמספר תלוי בסכימה של הספק. בעת החלפת נתונים, שמרו על הגדרת השדה ועל שם התקן.

המספר 344 עשוי להופיע גם במערכות אחרות, כולל נתוני מטבע. אין פירוש הדבר שהרשומות ניתנות להחלפה. השתמשו במונח קוד מספרי גאוגרפי כאשר משווים את ערך המדינה של ISO לערך מספרי של מטבע, ושמרו את שתי המשמעויות בשדות נפרדים בעלי טיפוס מתאים.

במה מזהים אחרים של הונג קונג שונים מקודי ISO

הקודים המוכרים האחרים של הונג קונג שימושיים, אך הם עונים על שאלות שונות. מערכת טלפונים זקוקה לקוד חיוג, מערכת תשלומים זקוקה לקוד מטבע, מסד נתונים ספורטיבי עשוי להזדקק לקוד אולימפי, והאינטרנט זקוק לתווית דומיין.

קוד החיוג הבינלאומי: ‎+852

+852 הוא קוד החיוג הטלפוני הבינלאומי של הונג קונג. הוא חלק ממערכת המספור של התקשורת ולא מזהה מדינה לפי ISO 3166-1. יישום טלפון עשוי להשתמש בו לניתוב או להצגת מספר בינלאומי, בעוד ששדה מדינה באותה רשומת לקוח עשוי להשתמש ב־HK.

לדוגמה, רשומת קישוריות עשויה להכיל country_iso_alpha2 = HK ו־ telephone_calling_code = +852. ערכים אלה מתארים מידע קשור על מיקום, אך אין לשמור אותם בשדה יחיד ולא מובחן של קוד מדינה. ה־ Office of the Communications Authority מספק מידע על תוכנית המספור של הונג קונג לשימושי תקשורת.

כאשר טופס מציין „קוד המדינה של הונג קונג”, קראו בקפידה את תוויות השדות הסמוכות. אם השדה שייך למספר טלפון, ייתכן שנדרש +852. אם מצוין ISO אלפא־2, הערך הרלוונטי הוא HK. שמרו את +852 בשדה של קוד חיוג טלפוני ולא בשדה של קוד מדינה ISO.

קוד המטבע: ‏HKD

HKD הוא הקוד האלפביתי לפי ISO 4217 לדולר הונג קונגי. הוא מזהה מטבע ולא מיקום גאוגרפי. לכן HKD שונה גם מ־HK וגם מ־HKG, אף שבשלושתם מופיעות אותיות הקשורות להונג קונג.

קופה, חשבונית או רשומה חשבונאית עשויות להפריד בין הערכים כך:

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

הקוד המספרי הגאוגרפי של ISO הוא 344. מערך נתוני מטבע עשוי גם לקשר את 344 לדולר הונג קונגי כקוד מטבע מספרי. המספר החוזר עלול לגרום לשגיאות נתונים, במיוחד כאשר טבלאות מדינה ומטבע מצורפות אוטומטית. שמרו את HKD ואת הקוד המספרי הגאוגרפי 344 בשדות נפרדים בעלי טיפוס מתאים, גם כאשר שתי המערכות משתמשות במספר 344.

לכן HKD אינו חלופה לקוד מדינה לפי ISO 3166-1. השתמשו בשדה המטבע המתועד של הספק הפיננסי עבור HKD, ובשדה הגאוגרפי המתאים עבור HK, ‏HKG או 344.

הקוד האולימפי: ‏HKG

הוועד האולימפי הבינלאומי משתמש ב־ HKG במערכת קודי הספורט שלו עבור הונג קונג. הדבר שימושי בעת קריאת תוצאות אולימפיות, טבלאות מדליות, רשימות נבחרות או הזנות ספורט המשתמשות בקיצורי IOC.

צ'אונג קא לונג מבצע קאמבק מדהים באליפות העולם

הערך תואם לקוד האלפא־3 של הונג קונג לפי ISO, אך ההתאמה אינה אומרת שכל קוד ספורט הוא קוד ISO. המשמעות נובעת ממערך הנתונים ומהארגון שהגדיר אותו. מסד נתונים כללי של מדינות עשוי לפרש את HKG כ־ISO 3166-1 אלפא־3, בעוד שקובץ תוצאות אולימפי עשוי לפרש אותו כקוד ספורט של IOC.

בעת מיפוי נתוני ספורט למסד נתונים כללי של מדינות, שמרו את שם מערכת המקור או התקן. התייחסו לערך התואם כנוחות פעולה הדדית ולא כהוכחה לכך ששתי מערכות הקודים זהות.

דומייני האינטרנט: ‎.hk ו־.香港

.hk הוא הדומיין העליון של הונג קונג בסקריפט לטיני, המשויך למדינה. הוא משמש ב־DNS ובכתובות אינטרנט, ולא כערך בשדה מדינה של ISO. הקשר שלו לערך האלפא־2 של ISO, ‏HK, מסייע לזהות את הטריטוריה שהדומיין מייצג, אך לשני המזהים מטרות טכניות שונות.

שינוי הגדרות DNS עבור דומייני HKDNR ‏(.com.hk וגם .hk)

.香港 הוא הדומיין העליון הבינלאומי של הונג קונג בסקריפט סיני, המשויך למדינה. דוח ההאצלה של IANA מתעד את האצלתו ל־Hong Kong Internet Registration Corporation Limited.

נתוני IANA על האצלת ‎.hk מזהים את Hong Kong Internet Registration Corporation כמנהל הדומיין העליון המשויך למדינה. בפועל, רישום דומיינים ואימות DNS עשויים לכלול כללים נפרדים מאימות קודי מדינה של ISO.

בתוכנות דומיינים, .香港 היא תווית בינלאומית. דפדפן או ספריית DNS עשויים להציג למשתמש את הצורה בסקריפט הסיני, ובמקביל לעבד באופן פנימי ייצוג תואם ASCII. השתמשו בתבנית הנדרשת על ידי ה־API הספציפי של הדומיין. לפני יישום כללי אימות או רישום עבור ‎.hk או .香港, בדקו את המידע העדכני של IANA ואת הדרישות העדכניות של Hong Kong Internet Registration Corporation.

שימוש בקודי הונג קונג בטפסים, בתוכנות ובנתונים

שגיאות קוד מתרחשות בדרך כלל כאשר שדה מקבל שם רחב מדי. אינטגרציה אמינה מזהה תחילה את התקן ואת התבנית, ולאחר מכן מאמתת את הערך מול ההגדרה הזו.

טפסים, מסדי נתונים וממשקי API

השתמשו ב־ HK רק כאשר טופס, API או שדה במסד נתונים מצפים במפורש ל־ISO 3166-1 אלפא־2. אם המפרט מציין אלפא־3, השתמשו ב־ HKG. אם מצוין ISO מספרי, השתמשו ב־ 344. שירות שמקבל תבנית אחת עשוי לדחות את האחרות או לפרש אותן בשקט באופן שגוי.

הדגמה | שלום, הפניה צולבת - חלק 1

יישום שמחליף כמה תבניות יכול לשמור מאפיינים נפרדים או להשתמש בטבלת חיפוש מבוקרת. דוגמה ידידותית לתרגום היא:

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

מאפיינים נפרדים הופכים את ההמרות למפורשות. הם גם מונעים ממפתח להכניס ערך בן שלוש אותיות לשדה בן שתי אותיות רק משום ששניהם מתארים את הונג קונג. אם ספק משתמש בשדה יחיד בשם country, קראו את התיעוד שלו כדי לקבוע אם הוא מקבל קוד ISO, שם תצוגה או מזהה אחר.

השתמשו באותיות ובסוג הנתונים שהשירות המקבל מגדיר. קודים אלפביתיים של ISO מוצגים בדרך כלל באותיות גדולות, אך API עשוי להחיל כללי אימות משלו. 344 מספרי עשוי להיות מיוצג כטקסט או כמספר שלם. טבלת חיפוש מבוקרת צריכה לתעד את סוג הקוד, תקן המקור, התבנית המתקבלת וכל מידע על גרסה או תאריך תחולה הנדרש לאינטגרציה.

לפני שליחת ערך של הונג קונג, אשרו אם הטופס או ה־API החיצוני מצפים לתבנית ISO אלפא־2, אלפא־3 או מספרית. אל תסיקו את הייצוג הנדרש מהמילים „קוד מדינה” בלבד.

תשלומים ודיווח פיננסי

מערכות תשלום ודיווח זקוקות לעיתים קרובות גם למידע גאוגרפי וגם למידע כספי. הפרידו ביניהם: לקוח או עסקה עשויים להשתמש ב־ HK כערך מדינה אלפא־2 של ISO, וב־ HKD כערך המטבע. מערכת אחרת עשויה לבקש במקום זאת HKG או 344 גאוגרפי.

לדוגמה, רשומת עסקה עשויה להכיל billing_country = HK, settlement_currency = HKD, ו־ currency_amount = 500.00. שמות השדות והקודים המתקבלים בפועל תלויים בשירות התשלומים, בבנק, בפלטפורמה החשבונאית או במפרט הדיווח.

המספר 344 דורש תשומת לב מיוחדת כאשר משלבים מערכי נתונים של מדינות, סטטיסטיקה ומטבעות. שמרו במיפוי את התקן שממנו הגיע הערך, כגון ISO 3166-1 מספרי גאוגרפי או ISO 4217 מספרי של מטבע. כך נמנעת התאמה סמנטית שגויה הנובעת מערך חוזר, וקל יותר להסביר את התוצאה במהלך התאמה או ביקורת.

הפרדת שדות טלפון, דומיין, מדינה ומטבע

פרופיל קישוריות עבור הונג קונג יכול להכיל כמה מזהים תקפים בו־זמנית:

פרויקט Node.js לקבלת רשימה של כל המדינות, המחוזות והערים בעולם בשורת הפקודה ב-JavaScript

• 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

ערכים אלה אינם גרסאות הניתנות להחלפה של קוד אחד. הם תומכים במשימות שונות: זיהוי מדינה, ניתוב טלפוני, עיבוד כספי ושמות דומיינים. הפרדתם משפרת את האימות, החיפוש, תוויות ממשק המשתמש ואת הפעולה ההדדית של ממשקי API.

שלב אימות סופי צריך לבדוק כל שדה מול התקן שהשירות המקבל מצפה לו. לדוגמה, אמתו את HK לפי כלל ISO אלפא־2, את +852 לפי כלל טלפוני, את HKD לפי כלל מטבע ואת ‎.hk לפי כלל דומיין. גישה שדה־אחר־שדה זו אמינה יותר מהחלת מאמת כללי אחד של קוד מדינה על כל הערכים.

הונג קונג, סין והקשר של שמות רשמיים

תקנים בינלאומיים, ארגונים וספקי תוכנה שונים עשויים להשתמש בתוויות באנגלית שונות עבור אותה רשומת הונג קונג. מערך נתונים עשוי להציג Hong Kong, Hong Kong, China, או ניסוח המזהה את הונג קונג כאזור מנהלי מיוחד של סין.

השתמשו יחד במערכת הקודים ובתווית הרשמית

יש לפרש הבדלי שמות בהקשר של מערכת המקור. התווית מספרת כיצד המקור מתאר את הרשומה, ואילו HK, ‏HKG או 344 מזהים את ערך הקוד ואת התבנית שבהם המערכת משתמשת. שינוי בשם אינו הופך קוד אלפא־2 לקוד אלפא־3, ואינו הופך קוד גאוגרפי לקוד מטבע או לקוד טלפון.

בעת שילוב מערכי נתונים, שמרו את תווית המקור, את סוג הקוד ואת כלל הצבירה. הדבר חשוב למסדי כתובות, לסטטיסטיקה, לתשלומים, למשלוחים ולמערכות דיווח. אל תחליפו את רשומת הונג קונג של המקור בתווית מדינה כללית ואל תמזגו אותה אוטומטית עם רשומה אחרת רק משום ששם התצוגה נראה דומה.

באינטגרציות עדכניות, ערכי ISO 3166-1 הרלוונטיים הם HK, HKG, ו־ 344. יש להשתמש בשם קודם או בקוד שיצא משימוש רק כאשר מערך נתונים היסטורי מתועד דורש זאת במפורש. בטפסים וב־API עדכניים רגילים, השתמשו בתבנית שהמערכת מבקשת ושמרו את תווית המקור בעת החלפת רשומות.

נקודות מרכזיות לגבי קודי ISO של הונג קונג

• HK הוא קוד ISO 3166-1 אלפא־2 של הונג קונג.
• HKG הוא קוד ISO 3166-1 אלפא־3 של הונג קונג, והוא מופיע גם בנתוני ספורט אולימפיים.
• 344 הוא הקוד המספרי הגאוגרפי של הונג קונג לפי ISO 3166-1.
• +852 הוא קוד החיוג הטלפוני הבינלאומי.
• HKD הוא קוד המטבע של הדולר ההונג קונגי.
• .hk ו־ .香港 הם דומיינים עליונים המשויכים למדינה של הונג קונג.

בחרו את הערך לפי התקן המתועד של השדה, ולא לפי הביטוי הכללי „קוד המדינה של הונג קונג”. שמירת מזהי המדינה, הטלפון, המטבע, הספורט והדומיין בשדות נפרדים מקלה על אימות נתוני הונג קונג ועל החלפתם המדויקת.