คุณสามารถปรับแต่งแผนที่สำหรับประเทศหรือภูมิภาคหนึ่งๆ ได้ด้วยวิธีต่อไปนี้
- เปลี่ยนการตั้งค่าภาษาเริ่มต้น
- ระบุรหัสภูมิภาค ซึ่งจะเปลี่ยนลักษณะการทำงานของแผนที่ตามประเทศหรือเขตแดนที่ระบุ
การแปลภาษา
โดยค่าเริ่มต้น Maps JavaScript API จะใช้การตั้งค่าภาษาที่ผู้ใช้ต้องการตามที่ระบุไว้ในเบราว์เซอร์ เมื่อแสดงข้อมูลแบบข้อความ เช่น ชื่อการควบคุม ประกาศเกี่ยวกับลิขสิทธิ์ เส้นทางการขับขี่ และป้ายกำกับบนแผนที่ ในกรณีส่วนใหญ่ คุณควรยึดตามการตั้งค่าเบราว์เซอร์ อย่างไรก็ตาม หากคุณต้องการให้ Maps JavaScript API ละเว้นการตั้งค่าภาษาของเบราว์เซอร์ คุณบังคับให้ 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 ซึ่ง (โดยทั่วไป) มีการแมปแบบ 1 ต่อ 1 กับโดเมนระดับบนสุดตามรหัสประเทศ (ccTLD) ตัวระบุภูมิภาค Unicode ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 alpha-2 โดยมีข้อยกเว้นที่สำคัญบางประการ เช่น ccTLD ของบริเตนใหญ่คือ "uk" (ตรงกับโดเมน .co.uk
) และตัวระบุภูมิภาคคือ "GB" ดูรายละเอียดการครอบคลุมของแพลตฟอร์ม Google Maps สำหรับภูมิภาคที่รองรับ
ลองใช้
การสาธิตนี้เพื่อทดสอบการเปลี่ยนแปลงบนแผนที่เมื่ออัปเดตพารามิเตอร์ 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
(สเปน) เป็น "โตเลโด สเปน"
ดู ตัวอย่างสำหรับสหรัฐอเมริกาและ ตัวอย่าง สเปน
การสาธิตการแปล
เมื่อตั้งค่าภาษาของแผนที่ คุณควรพิจารณาตั้งค่าภูมิภาคด้วย นี่คือการสาธิตที่ช่วยให้คุณสามารถโหลดแผนที่ที่มีภาษาและภูมิภาคที่คุณต้องการ
ดูการสาธิตนี้ในเต็มหน้าจอ