แนวทางปฏิบัติแนะนําเกี่ยวกับการใช้ Maps Static API

API เว็บแบบคงที่ของ Google Maps Platform คือชุดของอินเทอร์เฟซ HTTP ไปยังบริการของ Google ที่สร้างรูปภาพซึ่งคุณฝังลงในหน้าเว็บได้โดยตรง

คู่มือนี้อธิบายแนวทางปฏิบัติทั่วไปบางส่วนที่มีประโยชน์สําหรับการตั้งค่า รูปภาพ คําขอและการประมวลผลการตอบกลับบริการ โปรดอ่านคู่มือสําหรับนักพัฒนาซอฟต์แวร์เพื่อดูเอกสารประกอบฉบับเต็มของ Maps Static API

API เว็บแบบคงที่คืออะไร

API เว็บแบบคงที่ของ Google Maps Platform ช่วยให้คุณฝังรูปภาพ Google Maps ในหน้าเว็บได้โดยไม่ต้องใช้ JavaScript หรือการโหลดหน้าเว็บแบบไดนามิก API จะสร้างรูปภาพตามพารามิเตอร์ของ URL ที่ส่งผ่านคําขอ HTTP มาตรฐาน และช่วยให้คุณแสดงผลการค้นหาในหน้าเว็บได้

โดยทั่วไปคําขอ API แบบคงที่ของ Maps มักอยู่ในรูปแบบต่อไปนี้

https://maps.googleapis.com/maps/api/staticmap?parameters

หมายเหตุ: แอปพลิเคชัน Maps Static API ทั้งหมดต้องมีการตรวจสอบสิทธิ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์

การเข้าถึง SSL/TLS

ต้องมี HTTPS สําหรับคําขอ Google Maps Platform ทั้งหมดที่ใช้คีย์ API หรือมีข้อมูลผู้ใช้ คําขอที่สร้างผ่าน HTTP ที่มีข้อมูลที่ละเอียดอ่อนอาจถูกปฏิเสธ

การสร้าง URL ที่ถูกต้อง

คุณอาจจะคิดว่า"valid" URL นั้นชัดเจนในตัวเองอยู่แล้ว แต่กลับไม่เป็นเช่นนั้น ตัวอย่างเช่น URL ที่ป้อนในแถบที่อยู่ในเบราว์เซอร์อาจมีสัญลักษณ์พิเศษ (เช่น "上海+中國") เบราว์เซอร์ต้องแปลอักขระเหล่านั้นในรูปแบบการเข้ารหัสที่แตกต่างกันก่อนที่จะส่ง ในทํานองเดียวกัน โค้ดที่สร้างหรือยอมรับอินพุต UTF-8 อาจถือว่า URL ที่มีอักขระ UTF-8 เป็น "valid" แต่ก็ต้องแปลอักขระเหล่านั้นก่อนที่จะส่งออกจากเว็บเซิร์ฟเวอร์ กระบวนการนี้เรียกว่าการเข้ารหัส URL หรือการเข้ารหัสเปอร์เซ็นต์

สัญลักษณ์พิเศษ

เราต้องแปลสัญลักษณ์พิเศษเนื่องจาก URL ทั้งหมดต้องสอดคล้องกับไวยากรณ์ที่ระบุตามข้อกําหนด Uniform Resource Identifier (URI) ผลที่ได้คือ URL ต้องมีเฉพาะชุดย่อยของอักขระ ASCII ได้แก่ สัญลักษณ์ที่เป็นตัวอักษรและตัวเลขคละกันที่คุ้นเคย และอักขระที่สงวนไว้บางส่วนเพื่อใช้เป็นอักขระควบคุมภายใน URL ตารางนี้จะสรุปอักขระเหล่านี้

ตั้งค่า	ตัวอักขระ	การใช้ URL
ตัวอักษรและตัวเลขคละกัน	ก พ รั ด แ ล้ ว	สตริงข้อความ การใช้งานสคีม (http) พอร์ต (8080) และอื่นๆ
ไม่ได้จอง	- _ ~	สตริงข้อความ
จองแล้ว	! * ' ( ) ; : @ & = + $ , / ? % # [ ]	ควบคุมอักขระและ/หรือสตริงข้อความ

เมื่อสร้าง URL ที่ถูกต้อง คุณต้องตรวจสอบว่ามีเพียงอักขระเหล่านั้นเท่านั้นที่จะแสดงในตารางสรุปอักขระ URL ที่ถูกต้อง การกําหนด URL เพื่อใช้อักขระชุดนี้มักจะนําไปสู่ปัญหา 2 รายการ ได้แก่ การละเว้น 1 รายการและการแทนที่ด้วย 1 รายการต่อไปนี้

• อักขระที่คุณต้องการจัดการไม่อยู่ในชุดด้านบน ตัวอย่างเช่น อักขระในภาษาต่างประเทศ เช่น 上海+中國 ต้องเข้ารหัสโดยใช้อักขระข้างต้น ตามรูปแบบที่ได้รับความนิยม การเว้นวรรค (ซึ่งไม่อนุญาตให้ใช้ใน URL) มักจะแสดงด้วยอักขระ '+' บวกด้วย
• อักขระที่ตั้งข้างต้นเป็นอักขระที่สงวนไว้ แต่ต้องใช้ตามตัวอักษรเท่านั้น ตัวอย่างเช่น ระบบจะใช้ ? ภายใน URL เพื่อระบุจุดเริ่มต้นของสตริงการค้นหา หากต้องการใช้สตริง "? และ Mysterions&&tt;'d คุณต้องเข้ารหัสอักขระ '?'

อักขระทั้งหมดที่จะเข้ารหัส URL จะได้รับการเข้ารหัสโดยใช้อักขระ '%' และค่าเลขฐานสิบหกอักขระสองตัวที่สัมพันธ์กับอักขระ UTF-8 ตัวอย่างเช่น 上海+中國 ใน UTF-8 จะมีการเข้ารหัส URL เป็น %E4%B8%8A%E6%B5%B7%2B%E4%B8%AD%E5%9C%8B สตริง ? and the Mysterians จะมีการเข้ารหัส URL เป็น %3F+and+the+Mysterians หรือ %3F%20and%20the%20Mysterians

อักขระทั่วไปที่ต้องเข้ารหัส

อักขระทั่วไปที่ต้องเข้ารหัสมีดังนี้

อักขระที่ไม่ปลอดภัย	ค่าที่เข้ารหัส
เว้นวรรค	%20
"	%22
<	%3C
>	%3E
#	%23
%	%25
|	%7C

การแปลง URL ที่คุณได้รับจากอินพุตของผู้ใช้นั้นบางครั้งก็ยุ่งยาก เช่น ผู้ใช้สามารถป้อนที่อยู่เป็น "5th&Main St." โดยทั่วไปแล้ว คุณควรสร้าง URL จากส่วนต่างๆ โดยให้ถือว่าอินพุตของผู้ใช้เป็นอักขระตามตัวอักษร

นอกจากนี้ URL ต้องไม่เกิน 8192 อักขระสําหรับบริการเว็บ Google Maps Platform ทั้งหมดและ API เว็บแบบคงที่ สําหรับบริการส่วนใหญ่ ใกล้จะถึงจํานวนอักขระที่จํากัดแล้ว อย่างไรก็ตาม โปรดทราบว่าบริการบางประเภทมีพารามิเตอร์หลายรายการที่อาจส่งผลให้ URL ยาว