แปลแผนที่

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

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

การแปลภาษา

โดยค่าเริ่มต้น 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&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 ซึ่ง (โดยทั่วไป) มีการแมปแบบ 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&region=GB&callback=initMap">
</script>

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

ดู ตัวอย่างสำหรับสหรัฐอเมริกาและ ตัวอย่าง สเปน

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

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

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