คุณปรับแต่งแผนที่สำหรับประเทศหรือภูมิภาคที่เฉพาะเจาะจงได้ด้วยวิธีต่อไปนี้
- เปลี่ยนการตั้งค่าภาษาเริ่มต้น
- ระบุรหัสภูมิภาค ซึ่งจะปรับเปลี่ยนลักษณะการทำงานของแผนที่ตามประเทศหรือเขตแดนที่ระบุ
การแปลให้เหมาะกับท้องถิ่น
โดยค่าเริ่มต้น 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®ion=JP&language=ja&callback=initMap">
</script>
หากคุณตั้งค่าภาษาของแผนที่ คุณควรพิจารณาตั้งค่าภูมิภาคด้วย วิธีนี้ช่วยให้มั่นใจได้ว่าแอปพลิเคชันของคุณเป็นไปตามกฎหมายท้องถิ่น
หมายเหตุ: เมื่อคุณโหลด API ในลักษณะที่แสดงด้านบน แผนที่จะใช้ภาษาญี่ปุ่นสำหรับผู้ใช้ทุกคนโดยไม่คำนึงถึงค่ากำหนดของผู้ใช้ โปรดตรวจสอบว่าคุณต้องการทำงานลักษณะนี้ก่อนที่จะตั้งค่าตัวเลือกนี้
Maps JavaScript API ยังรองรับข้อความแบบ 2 ทิศทาง (Bidi) ที่มีอักขระทั้งในภาษาซ้ายไปขวา (LTR) และขวาไปซ้าย (RTL) ในตัว ตัวอย่างของภาษา RTL ได้แก่ อาหรับ ฮีบรู และฟาร์ซี โดยทั่วไป คุณควรระบุหน้าภาษา RTL เพื่อให้แสดงผลอย่างถูกต้องโดยการเพิ่ม dir='rtl'
ลงในองค์ประกอบ <html>
ของหน้าเว็บ ตัวอย่างต่อไปนี้แสดงแผนที่กรุงไคโร ประเทศอียิปต์ โดยใช้การควบคุมในภาษาอาหรับ
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async®ion=EG&language=ar&callback=initMap">
</script>
ดูรายการภาษาที่รองรับ โปรดทราบว่าเราเพิ่มภาษาใหม่ๆ เป็นประจำ ดังนั้นรายการนี้จึงอาจไม่ครอบคลุมทั้งหมด
การแปลภูมิภาค
เพิ่มพารามิเตอร์ region
ลงในแท็ก <script>
ขณะโหลดโค้ด Maps JavaScript API หากต้องการปรับเปลี่ยนแอปพลิเคชันให้แสดงชิ้นส่วนแผนที่ที่แตกต่างกัน หรือทำให้แอปพลิเคชันให้น้ำหนักพิเศษ (เช่น การให้น้ำหนักผลการระบุพิกัดทางภูมิศาสตร์ไปยังภูมิภาค)
ในฐานะนักพัฒนาซอฟต์แวร์แอปพลิเคชัน Maps JavaScript API เราขอแนะนำให้ตั้งค่าพารามิเตอร์ region
เสมอ เนื่องจากบริการต่างๆ (เช่น การเติมข้อความอัตโนมัติใน Places) มีแนวโน้มว่าจะให้ผลลัพธ์ที่ดีกว่าเมื่อตั้งค่า 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®ion=GB&callback=initMap">
</script>
ตัวอย่างต่อไปนี้แสดงแผนที่ 2 แผนที่ โดยแผนที่หนึ่งเป็นรหัสพิกัดภูมิศาสตร์ "โตเลโด" ตาม region
ที่ตั้งค่า US
(สหรัฐอเมริกา) เป็น "โตเลโด โอไฮโอ" และแผนที่หนึ่งให้น้ำหนักกับผลลัพธ์ตาม region
ซึ่งตั้งเป็น ES
(สเปน) เป็น "โตเลโด สเปน"
ดูตัวอย่างของสหรัฐอเมริกาและตัวอย่าง ES
การสาธิตการแปล
เมื่อตั้งค่าภาษาของแผนที่ คุณควรพิจารณาตั้งค่าภูมิภาคด้วย นี่คือการสาธิตที่ช่วยให้คุณสามารถโหลดแผนที่ด้วยภาษาและภูมิภาคที่คุณเลือก
ดูการสาธิตนี้ในเต็มหน้าจอ