คุณปรับแต่งแผนที่สำหรับบางประเทศหรือภูมิภาคได้ดังนี้
- เปลี่ยนการตั้งค่าภาษาเริ่มต้น
- ระบุรหัสภูมิภาค ซึ่งจะเปลี่ยนลักษณะการทํางานของแผนที่ตามประเทศหรือเขตแดนที่ระบุ
การปรับภาษา
โดยค่าเริ่มต้น 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
เสมอ เนื่องจากบริการต่างๆ (เช่น บริการป้อนข้อความอัตโนมัติของสถานที่) มีแนวโน้มที่จะให้ผลลัพธ์ที่ดีขึ้นเมื่อตั้งค่า region
นอกจากนี้ คุณมีหน้าที่ตรวจสอบว่าแอปพลิเคชันเป็นไปตามกฎหมายท้องถิ่นด้วย โดยตรวจสอบว่ามีการใช้การแปลเป็นภาษาท้องถิ่นของภูมิภาคที่ถูกต้องสำหรับประเทศที่โฮสต์แอปพลิเคชัน
พารามิเตอร์ region
จะยอมรับ
ตัวระบุแท็กย่อยระดับภูมิภาค Unicode ซึ่ง (โดยทั่วไป) มีการแมปแบบ 1:1 กับโดเมนระดับบนสุดตามรหัสประเทศ (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 แผนที่ แผนที่หนึ่งจับคู่พิกัดภูมิศาสตร์ "Toledo" ตาม region
ที่ตั้งค่าเป็น US
(สหรัฐอเมริกา) เป็น "Toledo, Ohio" และอีกแผนที่หนึ่งจับคู่พิกัดภูมิศาสตร์ตาม region
ที่ตั้งค่าเป็น ES
(สเปน) เป็น "Toledo, Spain"
ดูตัวอย่างในสหรัฐอเมริกาและสเปน
การสาธิตการแปล
เมื่อตั้งค่าภาษาของแผนที่ คุณควรพิจารณาตั้งค่าภูมิภาคด้วย ต่อไปนี้เป็นตัวอย่างที่ให้คุณโหลดแผนที่ด้วยภาษาและภูมิภาคที่เลือก
ดูการสาธิตนี้ในโหมดเต็มหน้าจอ