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

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

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

การแปลภาษา

โดยค่าเริ่มต้น 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&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&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 Platform สําหรับภูมิภาคที่รองรับ ลองใช้การสาธิตนี้เพื่อทดสอบการเปลี่ยนแปลงบนแผนที่เมื่อคุณอัปเดตพารามิเตอร์ region

ตัวอย่างเช่น แท็กสคริปต์ต่อไปนี้แปลแผนที่เป็นสหราชอาณาจักร

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&region=GB&callback=initMap">
</script>

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

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

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

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

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