API เว็บแบบคงที่ของ Google Maps Platform คือชุดอินเทอร์เฟซ HTTP สำหรับบริการของ Google ที่สร้างรูปภาพซึ่งคุณฝัง ในหน้าเว็บได้โดยตรง
คู่มือนี้อธิบายแนวทางปฏิบัติที่พบบ่อยบางอย่างที่คุณสามารถนำไปใช้ในการตั้งค่าคำขอรูปภาพและการประมวลผลการตอบกลับของบริการ ดูข้อมูลเพิ่มเติม เกี่ยวกับ Maps Static API ได้ที่คู่มือ สำหรับนักพัฒนาซอฟต์แวร์
Static Web API คืออะไร
Google Maps Platform Static Web API ช่วยให้คุณฝังรูปภาพ Google Maps ในหน้าเว็บได้โดยไม่ต้องใช้ JavaScript หรือการโหลดหน้าเว็บแบบไดนามิก API เว็บแบบคงที่จะสร้างรูปภาพตามพารามิเตอร์ URL ที่ส่งโดยใช้ คำขอ HTTPS มาตรฐาน
คำขอ Maps Static API ทั่วไปจะมีรูปแบบดังนี้
https://www.googleapis.com/staticmap/z/x/y?parameters
หมายเหตุ: แอปพลิเคชัน Maps Static API ทั้งหมดต้องมีการ ตรวจสอบสิทธิ์ ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์
การเข้าถึง TLS
ต้องใช้ HTTPS สำหรับคำขอ Google Maps Platform ทั้งหมดที่ใช้คีย์ API หรือมีข้อมูลผู้ใช้ คำขอที่ส่งผ่าน HTTP ซึ่งมีข้อมูลที่ละเอียดอ่อนอาจถูกปฏิเสธ
สร้าง URL ที่ถูกต้อง
คุณอาจคิดว่า URL ที่ "ถูกต้อง" นั้นชัดเจนในตัวอยู่แล้ว แต่
ในความเป็นจริงแล้วไม่ใช่ ตัวอย่างเช่น URL ที่ป้อนในแถบที่อยู่ในเบราว์เซอร์อาจมีอักขระพิเศษ (เช่น "上海+中國") เบราว์เซอร์ต้องแปลอักขระเหล่านั้นเป็นการเข้ารหัสอื่นภายในก่อนส่ง
ในทำนองเดียวกัน โค้ดที่สร้างหรือยอมรับอินพุต UTF-8
อาจถือว่า URL ที่มีอักขระ UTF-8 เป็น "ใช้ได้" แต่ก็จะต้อง
แปลอักขระเหล่านั้นก่อนส่งไปยังเว็บเซิร์ฟเวอร์ด้วย
กระบวนการนี้เรียกว่า
การเข้ารหัส URL หรือการเข้ารหัสเปอร์เซ็นต์
อักขระพิเศษ
เราต้องแปลอักขระพิเศษเนื่องจาก URL ทั้งหมดต้องเป็นไปตามไวยากรณ์ที่ระบุไว้ในข้อกำหนดของตัวระบุ ทรัพยากรแบบสม่ำเสมอ (URI) ซึ่งหมายความว่า URL ต้องมีเฉพาะอักขระ ASCII ที่เป็นชุดย่อยพิเศษ ได้แก่ สัญลักษณ์ตัวอักษรและตัวเลขที่คุ้นเคย และอักขระที่สงวนไว้บางตัวสำหรับใช้เป็นอักขระควบคุม ภายใน URL ตารางนี้สรุปอักขระดังกล่าว
| ตั้งค่า | อักขระ | การใช้ URL |
|---|---|---|
| ตัวอักษรและตัวเลขคละกัน | ก ข ค ง จ ฉ ช ซ ฌ ญ ฎ ฐ ฑ ฒ ณ ด ต ถ ท ธ น บ ป ผ พ ภ ม ย ร ล ว ศ ษ ส ห ฬ อ ฮ ก ข ค ง จ ฉ ช ซ ฌ ญ ฎ ฐ ฑ ฒ ณ ด ต ถ ท ธ น บ ป ผ พ ภ ม ย ร ล ว ศ ษ ส ห ฬ อ ฮ 0 1 2 3 4 5 6 7 8 9 | สตริงข้อความ การใช้รูปแบบ (http) พอร์ต (8080) ฯลฯ |
| ไม่ได้จอง | - _ . ~ | สตริงข้อความ |
| จองแล้ว | ! * ' ( ) ; : @ & = + $ , / ? % # [ ] | อักขระควบคุมและ/หรือสตริงข้อความ |
เมื่อสร้าง URL ที่ถูกต้อง คุณต้องตรวจสอบว่า URL นั้นมีเฉพาะอักขระที่แสดงในตาราง เท่านั้น การปรับ URL ให้ใช้ชุดอักขระนี้โดยทั่วไป จะทำให้เกิดปัญหา 2 อย่าง ได้แก่ ปัญหาการละเว้นและปัญหาการแทนที่
- ตัวละครที่คุณต้องการจัดการอยู่นอกเหนือชุดด้านบน
เช่น อักขระในภาษาต่างประเทศ
เช่น
上海+中國ต้องได้รับการเข้ารหัสโดยใช้อักขระ ด้านบน ตามธรรมเนียมที่นิยมใช้กัน ช่องว่าง (ซึ่งไม่อนุญาตให้ใช้ใน URL) มักจะแสดงโดยใช้อักขระบวก'+'ด้วย - อักขระจะอยู่ในชุดด้านบนเป็นอักขระที่สงวนไว้
แต่ต้องใช้ตามตัวอักษร
เช่น
?ใช้ภายใน URL เพื่อระบุ จุดเริ่มต้นของสตริงคำค้นหา หากต้องการใช้สตริง "? and the Mysterions" คุณจะต้องเข้ารหัสอักขระ'?'
อักขระทั้งหมดที่จะเข้ารหัส URL จะได้รับการเข้ารหัส
โดยใช้'%'และค่าเลขฐานสิบหก 2 อักขระ
ที่สอดคล้องกับอักขระ 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
อักขระทั่วไปที่ต้องมีการเข้ารหัส
อักขระที่พบบ่อยบางส่วนที่ต้องเข้ารหัสมีดังนี้
| อักขระที่ไม่ปลอดภัย | ค่าที่เข้ารหัส |
|---|---|
| Space | %20 |
| " | %22 |
| < | %3C |
| > | %3E |
| # | %23 |
| % | %25 |
| | | %7C |
บางครั้งการแปลง URL ที่คุณได้รับจากข้อมูลจากผู้ใช้อาจเป็นเรื่องยาก เช่น ผู้ใช้อาจป้อนที่อยู่เป็น "5th&Main St." โดยทั่วไป คุณควรกำหนดโครงสร้าง URL จากส่วนต่างๆ ของ URL โดยถือว่าข้อมูลจากผู้ใช้เป็นอักขระตามตัวอักษร
นอกจากนี้ URL ยังมีความยาวไม่เกิน 16384 ตัวสำหรับเว็บเซอร์วิสทั้งหมดของ Google Maps Platform และเว็บ API แบบคงที่ สำหรับบริการส่วนใหญ่ คุณแทบจะไม่ต้องกังวลเรื่องจำนวนอักขระสูงสุดนี้ อย่างไรก็ตาม โปรดทราบว่าบริการบางอย่างมีพารามิเตอร์หลายรายการที่อาจทำให้ URL ยาว