Hướng dẫn cấu hình vị trí bản đồ Google Maps trong CMS
Chọn đúng module bản đồ, giải thích Address, GoogleAPIKey, Zoom và địa chỉ dự phòng; kiểm tra vị trí hiển thị, lỗi bản đồ và liên kết.

Chức năng bản đồ dùng để làm gì?
Bản đồ giúp khách xác định vị trí doanh nghiệp trước khi đến giao dịch. Trong CMS, bạn có thể đặt địa chỉ, chọn mức phóng to và nhập khóa dịch vụ nếu skin yêu cầu. Để bản đồ hiển thị theo cấu hình, hãy gắn module đúng vị trí và dùng skin đọc các thông số này.
Các bước dưới đây giúp bạn đặt module và chỉnh thông số bản đồ. Nếu chưa có khóa phù hợp, hãy xem bài chuẩn bị khóa Google Maps trong mục Dịch vụ khác trước khi nhập. Nếu chỉ gõ sai địa chỉ, bạn có thể sửa ngay trong module mà không cần tạo tài khoản Cloud mới.
Giao diện xác định trang và module cần sửa
- Mở trang đang hiển thị bản đồ để xem bản đồ nằm ở đâu, chẳng hạn trong phần liên hệ hoặc ở cuối trang.
- Trong khu vực quản lý module và vị trí của CMS, chọn cấu hình mà trang đó đang dùng.
- Xác nhận module có phải GoogleMap hay không và xem module đang dùng skin nào. Tên hiển thị do quản trị viên đặt có thể khác tên chức năng.
- Mở phần thông số của module vừa xác định. Nếu có module cùng tên ở trang khác, hãy đối chiếu lại vị trí để sửa đúng bản đồ bạn đang xem.
Nếu trang không dùng module GoogleMap, hãy xem nó lấy dữ liệu chỉ đường từ đâu. Chẳng hạn, T99 dùng địa chỉ chi nhánh trong thông tin công ty để tạo liên kết chỉ đường. Liên kết đó mở Maps riêng, không hiển thị khung bản đồ ngay trên trang và không đọc tham số GoogleMap hay khóa GoogleAPIKey của module.
Giao diện thông số GoogleMap
Address - địa chỉ tìm trên bản đồ
Nhập tên hoặc số nhà, tên đường và khu vực để phân biệt địa điểm với những nơi có địa chỉ tương tự. Nếu skin dùng Maps Embed ở chế độ search, Maps sẽ dùng địa chỉ này làm từ khóa. Hãy mở kết quả để xác nhận Maps tìm đúng nơi bạn muốn hiển thị.
Nếu Address để trống, module lấy địa chỉ của chi nhánh đầu tiên trong dữ liệu công ty. Module chỉ dùng địa chỉ đó, không hiển thị toàn bộ chi nhánh hay tìm chi nhánh gần người xem nhất. Muốn chỉ đúng một địa điểm, hãy nhập địa chỉ vào Address để vị trí không phụ thuộc vào thứ tự chi nhánh.
Nếu doanh nghiệp chưa có chi nhánh hoặc dữ liệu chi nhánh còn thiếu địa chỉ, hãy khai báo nguồn địa chỉ trước. Khi bạn để trống Address, module cũng không tự lấy vị trí GPS của người truy cập.
GoogleAPIKey - khóa dịch vụ
Nhập API key của dịch vụ mà skin đang gọi. Chẳng hạn, skin dùng iframe Maps Embed như T34 cần khóa được thiết lập cho Maps Embed API. Ô này chỉ nhận chuỗi khóa. Mật khẩu Google, URL địa chỉ và cả đoạn mã nhúng đều không dùng được ở đây.
Khóa cần được phép dùng trên tên miền hiển thị bản đồ. Nếu bản đồ chạy ở trang thử nghiệm nhưng lỗi trên tên miền thật, hãy kiểm tra giới hạn tên miền của khóa. Khi dịch vụ từ chối khóa, sửa Address sẽ không khắc phục được lỗi.
Zoom - mức phóng to
Nhập một số trong phạm vi mà dịch vụ và skin hỗ trợ. Số lớn hơn thường cho góc nhìn gần hơn, còn số nhỏ hơn cho thấy khu vực rộng hơn. Chọn mức sao cho khách thấy rõ địa điểm và vẫn nhìn được các đường lân cận để định hướng.
Phóng quá gần có thể khiến khách khó nhận ra khu vực. Thu quá xa lại khó phân biệt cửa hàng với những địa điểm xung quanh. Sau khi lưu, hãy xem bản đồ trên màn hình thực tế để biết mức thu phóng đã phù hợp chưa.
Giao diện skin và vị trí hiển thị
Module cung cấp dữ liệu bản đồ. Skin quyết định khung bản đồ hiển thị ra sao. Ví dụ, skin GoogleMap T34 dùng toàn bộ chiều rộng của vùng hiển thị và đọc chiều cao từ cấu hình skin. Nếu đặt chiều cao bằng 0, skin này dùng 200 px. Các template khác có thể xử lý chiều cao theo cách riêng.
Nếu khung bản đồ quá thấp, hãy chỉnh chiều cao trong cấu hình giao diện đang dùng. Nếu bản đồ không xuất hiện ở trang cần dùng, hãy xem lại vị trí module và phạm vi trang được gán. Vị trí hiển thị do cấu hình module quyết định nên đổi khóa sẽ không chuyển bản đồ sang trang khác.
Lưu và kiểm tra ngoài website
- Kiểm tra đúng module, nhập Address, GoogleAPIKey và Zoom theo nhu cầu.
- Lưu thông số, chờ xác nhận thành công.
- Mở lại trang trên tên miền khách sử dụng. Nếu vẫn thấy dữ liệu cũ, hãy kiểm tra và xóa bộ nhớ đệm của đúng website theo hướng dẫn cache của CMS.
- Kiểm tra địa điểm, mức phóng to, chiều cao và việc mở bản đồ trên điện thoại.
- Bấm liên kết bản đồ nếu skin có cung cấp để chắc chắn dẫn tới đúng nơi khách cần đến.
Xử lý các tình huống thường gặp
- Bản đồ tải nhưng sai vị trí: nhập địa chỉ đầy đủ. Nếu Address đang trống, hãy kiểm tra địa chỉ của chi nhánh đầu tiên mà module đang dùng.
- Khung trống hoặc dịch vụ báo lỗi: đối chiếu API, khóa, giới hạn website và điều kiện dịch vụ Google.
- Đổi địa chỉ nhưng trang không đổi: kiểm tra đúng module/skin và cache trước khi sửa lại lần nữa.
- Muốn hiển thị nhiều chi nhánh: chọn cách cấu hình module hoặc giao diện hỗ trợ nhiều điểm. Một tham số Address không tự tạo danh sách các chi nhánh.
- T99 chỉ có nút xem đường đi: kiểm tra địa chỉ mà skin lấy từ thông tin doanh nghiệp. Với cách tích hợp này, nút chỉ đường mở Maps riêng nên trang không cần khung GoogleMap.
Khi cần đối chiếu dịch vụ nhúng, xem hướng dẫn Maps Embed API của Google. Trước khi thay đổi cách tích hợp, hãy xem skin đang dùng trên website. Một ảnh hướng dẫn của template khác chưa đủ để xác định cách cấu hình cho trang của bạn.