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