Hướng dẫn chuẩn bị khóa Google Maps cho website
Phân biệt bản đồ nhúng, Maps API và liên kết chỉ đường; chuẩn bị khóa đúng loại, giới hạn tên miền và kiểm tra trước khi cấu hình CMS.
Bài này dùng để làm gì?
Trước khi đưa khóa Google Maps vào CMS, người quản lý cần xác định website có thực sự cần khóa hay không và chuẩn bị đúng loại. Bài này hướng dẫn phần chuẩn bị dịch vụ; còn cách đặt bản đồ, nhập địa chỉ và chọn mức phóng to nằm trong bài cấu hình bản đồ liên quan. Chuẩn bị dịch vụ và bố trí module là hai công việc riêng.
Không phải mọi nút “Xem đường đi” đều cần API key. Vì vậy, trước khi tạo khóa, hãy xác định giao diện đang dùng liên kết mở Google Maps, iframe nhúng hay bản đồ lập trình. Nếu tạo sai loại khóa hoặc bật sai API, bản đồ có thể vẫn không hoạt động dù chuỗi khóa đã nhập hợp lệ.
Giao diện website: nhận diện cách tích hợp
Liên kết mở Google Maps
Người xem bấm liên kết để mở Google Maps và xem vị trí hoặc đường đi. Ở skin giới thiệu công ty của T99, địa chỉ được lấy từ chi nhánh đầu tiên để tạo liên kết tìm trên Google Maps. Phần này không phải module bản đồ dùng GoogleAPIKey, nên bạn không cần tạo khóa chỉ để sửa liên kết.
Module GoogleMap dùng khóa
Một số skin, chẳng hạn GoogleMap của T34, dùng iframe nhúng theo Maps Embed API ở chế độ search. Module đọc ba tham số Address, GoogleAPIKey và Zoom. Với loại skin này, bạn cần chuẩn bị khóa cho Maps Embed API. Không mặc định rằng chỉ bật Maps JavaScript API là đủ.
Bản đồ JavaScript hoặc iframe chia sẻ khác
Yêu cầu dịch vụ có thể khác khi website dùng skin tùy biến bằng JavaScript. Cách dán iframe chia sẻ từ Google Maps cũng khác với cấu hình module đọc GoogleAPIKey. Trước khi chọn hướng dẫn dịch vụ, hãy nhờ người quản trị template xác định đúng skin đang chạy.
Giao diện Google Cloud: chuẩn bị khóa cho Maps Embed API
Tài khoản quản lý Cloud cần thuộc về người hoặc đơn vị chịu trách nhiệm vận hành dịch vụ. Không nên dùng tài khoản cá nhân của nhân viên sắp bàn giao công việc rồi để mất quyền quản lý khóa.
- Mở dự án Google Cloud sẽ dùng cho website hoặc tạo dự án phù hợp.
- Hoàn thành các yêu cầu thiết lập dự án và thanh toán mà Google hiển thị, rồi bật Maps Embed API.
- Mở khu vực thông tin xác thực và tạo API key.
- Đặt giới hạn ứng dụng cho website và giới hạn API tương ứng trước khi sử dụng.
Đối chiếu từng bước theo tài liệu thiết lập Maps Embed API của Google. Yêu cầu tài khoản, hạn mức và chính sách dịch vụ có thể thay đổi; không dùng hướng dẫn cũ hứa rằng mọi dịch vụ Maps đều miễn phí hoặc mọi loại khóa dùng thay nhau được.
Giao diện giới hạn khóa
Giới hạn website chỉ cho phép các tên miền đã khai báo sử dụng khóa từ trình duyệt. Hãy khai báo những địa chỉ website thực tế sẽ chạy bản đồ, gồm cả bản có www và không www nếu doanh nghiệp sử dụng cả hai. Chỉ nên thêm môi trường thử nghiệm khi thật sự cần.
Giới hạn API xác định dịch vụ nào được phép nhận yêu cầu bằng khóa. Chọn đúng API mà skin sử dụng. Dù tên miền đã đúng, khóa vẫn có thể không chạy nếu bị giới hạn sai API. Xem khuyến nghị bảo vệ API key của Google Maps.
Trong hồ sơ vận hành nội bộ, hãy ghi lại dự án, người quản lý, website sử dụng và ngày bàn giao. Không đưa khóa vào bài hướng dẫn công khai để người đọc sao chép. Với khóa xuất hiện trong yêu cầu từ trình duyệt, cần đặt giới hạn đúng để bảo vệ khóa; chỉ giấu chuỗi trong CMS là chưa đủ.
Giao diện CMS: bàn giao khóa cho module
Khi đã có khóa, hãy mở đúng cấu hình module GoogleMap của website đang triển khai, nhập khóa vào trường GoogleAPIKey rồi lưu. Trường này chỉ nhận chuỗi khóa, nên không dán cả đoạn iframe, đường dẫn Cloud hoặc tên dự án vào đây.
Nếu không thấy trường GoogleAPIKey, hãy kiểm tra loại module và skin. Đừng tạo một tham số tùy ý rồi cho rằng website sẽ tự dùng. Với T99 đang dùng liên kết chỉ đường trong phần thông tin công ty, bạn cần chỉnh đúng địa chỉ nguồn; khóa Cloud không sửa được địa chỉ sai.
Kiểm tra trước khi hoàn tất
- Mở trang thật trên tên miền đã được cho phép, không chỉ trên máy quản trị.
- Kiểm tra xem khung bản đồ có tải được không và địa điểm đã đúng chưa.
- Thử trên điện thoại để kiểm tra khung và thao tác mở Maps.
- Nếu bản đồ không tải, hãy đối chiếu API đã bật, giới hạn khóa, tên miền và thông báo dịch vụ trước khi thay khóa liên tục.
- Nếu bản đồ tải được nhưng sai vị trí, hãy kiểm tra Address và mức Zoom. Nguyên nhân thường nằm ở dữ liệu địa chỉ hoặc cách tìm địa điểm, không phải lỗi mật khẩu tài khoản Cloud.
Khi khóa đã hoạt động, bạn tiếp tục cấu hình địa chỉ và vị trí module. Hãy giữ lại thông tin bàn giao để người vận hành sau biết cần kiểm tra đúng dự án nào khi đổi tên miền hoặc thay khóa.