התאמה של המפה לשוק המקומי

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

  • שינוי הגדרות ברירת המחדל של השפה.
  • ניתן לציין קוד אזור שמשנה את ההתנהגות של המפה בהתאם למדינה או לאזור ספציפיים.

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

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

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

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

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

לצפייה בדוגמה

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

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

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

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

דוגמה

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

התאמה מקומית של האזור

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

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

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

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

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

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

מומלץ לעיין בדוגמה לארה"ב ובדוגמה ל-ES.

הדגמה של לוקליזציה

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

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