การแปลแผนที่

คุณปรับแต่งแผนที่สำหรับประเทศหรือภูมิภาคที่เฉพาะเจาะจงได้ด้วยวิธีต่อไปนี้

  • เปลี่ยนการตั้งค่าภาษาเริ่มต้น
  • ระบุรหัสภูมิภาค ซึ่งจะปรับเปลี่ยนลักษณะการทำงานของแผนที่ตามประเทศหรือเขตแดนที่ระบุ

การแปลให้เหมาะกับท้องถิ่น

โดยค่าเริ่มต้น 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&region=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&region=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&region=GB&callback=initMap">
</script>

ตัวอย่างต่อไปนี้แสดงแผนที่ 2 แผนที่ โดยแผนที่หนึ่งเป็นรหัสพิกัดภูมิศาสตร์ "โตเลโด" ตาม region ที่ตั้งค่า US (สหรัฐอเมริกา) เป็น "โตเลโด โอไฮโอ" และแผนที่หนึ่งให้น้ำหนักกับผลลัพธ์ตาม region ซึ่งตั้งเป็น ES (สเปน) เป็น "โตเลโด สเปน"

ดูตัวอย่างของสหรัฐอเมริกาและตัวอย่าง ES

การสาธิตการแปล

เมื่อตั้งค่าภาษาของแผนที่ คุณควรพิจารณาตั้งค่าภูมิภาคด้วย นี่คือการสาธิตที่ช่วยให้คุณสามารถโหลดแผนที่ด้วยภาษาและภูมิภาคที่คุณเลือก

ดูการสาธิตนี้ในเต็มหน้าจอ