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

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

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

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

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

גם ה-JavaScript API של מפות Google תומך דו-כיווני (Bidi) טקסט שמכיל תווים גם משמאל לימין (LTR) וגם שפות שנכתבות מימין לשמאל (RTL). דוגמאות לשפות בפורמט 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>

להצגת דוגמה

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

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

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

בתור המפתח של Maps JavaScript 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&loading=async&region=GB&callback=initMap">
</script>

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

הצגה של ארה"ב דוגמה ES דוגמה.

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

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

אפשר לצפות בהדגמה הזו במסך מלא.