Các phương pháp hay nhất khi sử dụng API tĩnh của Maps

API web tĩnh của Nền tảng Google Maps là một tập hợp các giao diện HTTP đến các dịch vụ của Google để tạo ra những hình ảnh mà bạn có thể nhúng trực tiếp vào trang web của mình.

Hướng dẫn này mô tả một số phương pháp phổ biến giúp bạn thiết lập yêu cầu đối với hình ảnh và xử lý phản hồi của dịch vụ. Tham khảo hướng dẫn dành cho nhà phát triển để xem tài liệu đầy đủ về API tĩnh của Maps.

API Web tĩnh là gì?

Thông thường, một yêu cầu API tĩnh của Maps thường có dạng như sau:

  https://www.googleapis.com/staticmap/z/x/y?parameters

Lưu ý: Tất cả ứng dụng Maps Static API đều yêu cầu xác thực. Xem thêm thông tin về thông tin xác thực.

Truy cập SSL/TLS

HTTPS là yêu cầu bắt buộc đối với tất cả các yêu cầu trên Nền tảng Google Maps sử dụng khoá API hoặc chứa dữ liệu người dùng. Những yêu cầu được thực hiện qua HTTP chứa dữ liệu nhạy cảm có thể bị từ chối.

Tạo URL hợp lệ

Có thể bạn cho rằng một URL "hợp lệ" là điều hiển nhiên, nhưng điều đó không đúng. Ví dụ: URL được nhập trong thanh địa chỉ trong trình duyệt có thể chứa các ký tự đặc biệt (ví dụ: "上海+中國"); trình duyệt cần dịch nội bộ các ký tự đó sang một kiểu mã hoá khác trước khi truyền. Tương tự như vậy, mọi mã tạo hoặc chấp nhận dữ liệu đầu vào UTF-8 có thể coi URL có ký tự UTF-8 là "hợp lệ", nhưng cũng cần phải dịch các ký tự đó trước khi gửi đến máy chủ web. Quá trình này gọi là mã hoá URL hoặc mã hoá phần trăm.

Các ký tự đặc biệt

Chúng tôi cần dịch các ký tự đặc biệt vì tất cả URL đều phải tuân thủ cú pháp được chỉ định trong thông số kỹ thuật Mã nhận dạng tài nguyên đồng nhất (URI). Trên thực tế, điều này có nghĩa là URL chỉ được chứa một tập hợp con ký tự ASCII đặc biệt: ký hiệu chữ và số quen thuộc và một số ký tự dành riêng để dùng làm ký tự điều khiển trong URL. Bảng này tóm tắt các ký tự sau:

Khi tạo một URL hợp lệ, bạn phải đảm bảo rằng URL đó chỉ chứa các ký tự hiển thị trong bảng. Việc tạo một URL để sử dụng tập hợp ký tự này thường dẫn đến 2 vấn đề, một là bị bỏ sót và một là bị thay thế:

• Các ký tự bạn muốn xử lý tồn tại ngoài nhóm ở trên. Ví dụ: bạn cần mã hoá các ký tự bằng tiếng nước ngoài như 上海+中國 bằng các ký tự trên. Theo quy ước phổ biến, dấu cách (không được phép trong URL) cũng thường được biểu thị bằng ký tự dấu cộng '+'.
• Các ký tự tồn tại trong tập hợp nêu trên dưới dạng ký tự dành riêng, nhưng cần được sử dụng theo nghĩa đen. Ví dụ: ? được dùng trong các URL để cho biết điểm bắt đầu của chuỗi truy vấn; nếu muốn dùng chuỗi "? và Chuỗi ẩn số", bạn cần mã hoá ký tự '?'.

Tất cả các ký tự cần mã hoá URL đều được mã hoá bằng ký tự '%' và một giá trị hex gồm hai ký tự tương ứng với ký tự UTF-8. Ví dụ: 上海+中國 trong UTF-8 sẽ được mã hoá URL dưới dạng %E4%B8%8A%E6%B5%B7%2B%E4%B8%AD%E5%9C%8B. Chuỗi ? and the Mysterians sẽ được mã hoá URL thành %3F+and+the+Mysterians hoặc %3F%20and%20the%20Mysterians.

Các ký tự phổ biến cần mã hoá

Một số ký tự phổ biến phải được mã hoá là:

Đôi khi, việc chuyển đổi một URL mà bạn nhận được từ hoạt động đầu vào của người dùng đôi khi khá phức tạp. Ví dụ: người dùng có thể nhập địa chỉ là "5th&Main St." Nhìn chung, bạn nên tạo URL từ các phần của URL đó, coi mọi hoạt động đầu vào của người dùng là các ký tự cố định.

Ngoài ra, URL chỉ được có tối đa 16384 ký tự đối với tất cả các dịch vụ web và API web tĩnh trên Nền tảng Google Maps. Đối với hầu hết các dịch vụ, hiếm khi đạt đến giới hạn ký tự này. Tuy nhiên, hãy lưu ý rằng một số dịch vụ nhất định có một số tham số có thể dẫn đến URL dài.