התאמת המפה לשוק המקומי (לוקליזציה)

אפשר להתאים אישית את המפה למדינה או לאזור ספציפיים בדרכים הבאות:

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

לוקליזציה של שפה

כברירת מחדל, Maps JavaScript API משתמש בהגדרת השפה המועדפת של המשתמש כפי שהוגדרה בדפדפן, כשמוצג מידע טקסטואלי כמו שמות של אמצעי בקרה, הודעות זכויות יוצרים, הוראות נסיעה ותוויות במפות. ברוב המקרים, עדיף לכבד את הגדרות הדפדפן. עם זאת, אם רוצים שממשק Maps JavaScript API יתעלם מהגדרת השפה של הדפדפן, אפשר להוסיף פרמטר language לתג <script> כשמטעינים את קוד Maps JavaScript API, וכך לכפות על הממשק להציג מידע בשפה מסוימת.

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

בדוגמה הבאה מוצגת מפה ביפנית והאזור מוגדר ליפן:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=JP&language=ja&callback=initMap">
</script>

לדוגמה

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

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

‫Maps JavaScript API תומך באופן מובנה גם בטקסט דו-כיווני (Bidi) שמכיל תווים בשפות שמוצגות משמאל לימין (LTR) ומימין לשמאל (RTL). דוגמאות לשפות RTL כוללות ערבית, עברית ופרסית. בדרך כלל, כדי שדפים בשפה שנכתבת מימין לשמאל יוצגו בצורה תקינה, צריך להוסיף את התג dir='rtl' לרכיב <html> של הדף. בדוגמה הבאה מוצגת מפה של קהיר, מצרים, עם אמצעי בקרה בערבית:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=EG&language=ar&callback=initMap">
</script>

לדוגמה

שפות נתמכות

‫Google מעדכנת לעיתים קרובות את השפות הנתמכות. הרשימה הזו חלקית בלבד והיא עשויה להשתנות.

קוד שפה שפה קוד שפה שפה
af אפריקאנס ja יפנית
sq אלבנית kn קנאדה
am אמהרית kk קזחית
ar ערבית ק"מ חמרית
hy ארמנית ko קוריאנית
az אזרית ky קירגיזית
eu בסקית lo לאו
be בלארוסית lv לטבית
bn בנגלית lt ליטאית
bs בוסנית mk מקדונית
bg בולגרית ms מלאית
my בורמזית ml מליאלאם
ca קטלאנית mr מראטהית
zh סינית mn מונגולית
zh-CN סינית (פשוטה) ne נפאלית
zh-HK סינית (הונג קונג) לא נורווגית
zh-TW סינית (מסורתית) pl פולנית
שעה קרואטית pt פורטוגזית
cs צ'כית pt-BR פורטוגזית (ברזיל)
da דנית pt-PT פורטוגזית (פורטוגל)
nl הולנדית pa פנג'אבי
en אנגלית ro רומנית
en-AU אנגלית (אוסטרליה) ru רוסית
en-GB אנגלית (בריטניה) sr סרבית (באותיות קיריליות)
et אסטונית sr-Latn סרבית (אותיות לטיניות)
fa פרסית si סינהלית
fi פינית sk סלובקית
fil פיליפינית sl סלובנית
fr צרפתית es ספרדית
fr-CA צרפתית (קנדה) es-419 ספרדית (אמריקה הלטינית)
gl גליציאנית sw סווהילי
ka גאורגית sv שוודית
de גרמנית ta טמילית
el יוונית te טלוגו
gu גוג'ראטי th תאית
iw עברית tr טורקית
hi הינדי uk אוקראינית
hu הונגרית ur אורדו
is איסלנדית uz אוזבקית
id [מזהה] אינדונזית vi וייטנאמית
it איטלקית zu זולו

לוקליזציה של אזורים

מוסיפים פרמטר region לתג <script> כשמטעינים את הקוד של Maps JavaScript API, אם רוצים לשנות את האפליקציה כדי להציג אריחי מפה שונים או להטות את האפליקציה (למשל, להטות את תוצאות המרת כתובות לקואורדינטות (geocoding) לכיוון האזור).

אם אתם מפתחים אפליקציה שמבוססת על Maps JavaScript API, מומלץ להגדיר תמיד פרמטר region, כי שירותים שונים (כמו השלמה אוטומטית למקומות) נוטים לספק תוצאות טובות יותר כשהפרמטר region מוגדר. באחריותכם גם לוודא שהאפליקציה עומדת בדרישות החוק המקומי. לשם כך, עליכם לוודא שהלוקליזציה הנכונה של האזור חלה על המדינה שבה האפליקציה מתארחת.

הפרמטר region מקבל מזהים של תגי משנה של אזור Unicode, שבדרך כלל יש להם מיפוי אחד לאחד לדומיינים ברמה העליונה עם קוד מדינה (ccTLD). רוב מזהי האזור ב-Unicode זהים לקודים לפי תקן ISO 3166-1 alpha-2, אבל יש כמה יוצאים מן הכלל. לדוגמה, קוד ה-ccTLD של בריטניה הוא uk (שמתאים לדומיין .co.uk), אבל מזהה האזור שלה הוא GB. מידע על האזורים הנתמכים זמין במאמר בנושא פרטים על הכיסוי של Google Maps Platform. כדאי לנסות את ההדגמה הזו כדי להתנסות בשינויים במפה כשמעדכנים את הפרמטר region.

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

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=GB&callback=initMap">
</script>

בדוגמאות הבאות מוצגות שתי מפות. באחת מתבצע גיאו-קידוד של 'טולדו' על סמך region שמוגדר ל-US (ארה"ב) ל'טולדו, אוהיו'. בשנייה מתבצע הטיה של התוצאות על סמך region שמוגדר ל-ES (ספרד) ל'טולדו, ספרד'.

אפשר לראות את הדוגמה של ארה"ב ואת הדוגמה של ספרד.

הדגמה של התאמה לשוק המקומי

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

צפייה בהדגמה הזו במסך מלא