Viin Giao diện Bản đồ
bởi Viindoo
| Số dòng Code | 2083 |
| Tên kỹ thuật | viin_web_map |
| Giấy phép | OPL-1 |
| Website | https://viindoo.com/apps/modules/18.0/viin_web_map?force_show=1 |
| Đọc mô tả cho | v 13.0 v 14.0 v 15.0 v 16.0 v 17.0 |
| Các mở rộng | Viin CRM Bản đồ liên hệ Viin Kho vận - Giao diện Enterprise Bản đồ Nhân viên |
Viin Map View
Interactive map view for locations and routes with flexible configurations.
Key Features
Built natively on Odoo/Viindoo to streamline real business operations:
Location Display
Markers for records with latitude and longitude.
Routing Support
Visualize routes between waypoints with optional polylines.
Customizable Popups
Define information displayed in marker popups.
Flexible Providers
Compatible with OpenStreetMap, Google, Mapbox, and HERE.
Demo Video
Viin Map View.
See Viin Map View in Action
See how this module solves real business problems in a working Viindoo environment.
Need help with Viin Map View?
For questions, implementation support, or consulting services, contact Viindoo.
Pre-Sales & Partnership
When contacting us, please include:
- Odoo/Viindoo version (Odoo CE / Viindoo Editions).
- Number of users and business scope.
- Other modules currently in use.
Technical Support
For faster troubleshooting, please provide:
- Order number or app reference.
- Odoo/Viindoo version & edition.
- Steps to reproduce the issue.
- Screenshots/logs if available.
Technical Requirement
Changes log
We continuously improve this module. Recent updates from the official Viindoo repository:
- 2026-02-15 Fixed Prevent geo-localization cron storm when OSM blocks.
- 2025-12-04 Fixed Avoid crashing when no lat/long available.
- 2024-12-06 Improved Now support real map route using polyline by map providers.
- 2024-11-26 Improved Remove res.partner override.
Works Great With These Modules
Extend Viin Map View with complementary Viindoo apps:
Contacts Map
Adds notably the map view of contacts
Module viin_contacts_mapViin CRM
Advanced features for CRM
Module viin_crmEmployees Map
View employees in map view
Module viin_employee_mapGeo Route Map
Display geo-optimized routes on interactive Viindoo web maps
Module viin_geo_route_mapViin Warehouse
Advanced Warehouse features
Module viin_stockWho Should Use This Module?
Built for teams that need this capability fully integrated into their Odoo/Viindoo stack.
Executives & Business Owners
Need clear visibility into operations and a stack that scales without bespoke development.
Operations / Department Leaders
Want to streamline daily workflows, remove manual handoffs, and keep data consistent across teams.
Implementers & Odoo Partners
Looking for production-ready Viindoo modules to deliver projects faster and at lower risk.
Tài liệu viin_web_map
Tổng quan
Module viin_web_map cho phép bạn tích hợp bản đồ tương tác vào hệ thống Odoo. Module này hỗ trợ hiển thị vị trí và tuyến đường trực tiếp trên bản đồ, phù hợp cho các ứng dụng dựa trên vị trí. Bạn có thể cấu hình và trực quan hóa các vị trí riêng lẻ (dùng marker) và tuyến đường (dùng waypoint).
Tính năng chính
- Hiển thị vị trí: Hiển thị dữ liệu vị trí bằng các marker trên bản đồ.
- Hiển thị tuyến đường: Trực quan hóa tuyến đường qua nhiều waypoint.
- Tùy chỉnh popup: Cá nhân hóa thông tin hiển thị trong popup của marker.
- Google Directions: Tùy chọn hiển thị chỉ dẫn từ Google Directions API.
- Tự động tạo polyline: Polyline tự động được tạo từ waypoint nếu không được định nghĩa trước.
- Cấu hình linh hoạt: Dễ dàng cấu hình và mở rộng để phù hợp với nhu cầu.
Cài đặt
Cài đặt module viin_web_map qua giao diện Odoo Apps hoặc sử dụng lệnh:
odoo-bin -c <config_file> -i viin_web_map
Cấu hình Maps API key cho 1 trong số các nhà cung cấp dịch vụ bản đồ Mapbox, Google và HERE nếu bạn muốn sử dụng tính năng định vị của một trong các nhà cung cấp này.
Sử dụng
Cấu hình view viin_map
View viin_map có thể được sử dụng để hiển thị vị trí hoặc tuyến đường trên bản đồ. Dưới đây là các ví dụ về cách cấu hình view cho từng trường hợp.
### Hiển thị dữ liệu vị trí
Để hiển thị vị trí dưới dạng marker trên bản đồ, bạn có thể cấu hình view viin_map cho model như res.partner. View này sẽ hiển thị mỗi đối tượng partner như một marker trên bản đồ kèm thông tin trong popup.
Ví dụ về view viin_map hiển thị vị trí:
<record id="res_partner_view_map" model="ir.ui.view"> <field name="name">res.partner.view.map</field> <field name="model">res.partner</field> <field name="arch" type="xml"> <viin_map res_partner="id"> <marker-popup> <field name="name" string="Tên"/> <field name="mapping_address" string="Địa chỉ"/> </marker-popup> </viin_map> </field> </record>
Giải thích: - res_partner="id": Bản đồ sử dụng trường id của model res.partner để xác định vị trí trên bản đồ. - marker-popup: Chỉ định các trường sẽ hiển thị trong popup của marker, trong ví dụ này là name và mapping_address.
### Hiển thị tuyến đường
Để hiển thị tuyến đường qua nhiều waypoint, bạn có thể cấu hình view viin_map với thuộc tính routing="true". Nếu không định nghĩa trường polyline, nó sẽ được tạo tự động từ waypoint.
Ví dụ về view viin_map hiển thị tuyến đường:
<record id="view_route_route_map" model="ir.ui.view"> <field name="name">route.route.viin_map</field> <field name="model">route.route</field> <field name="arch" type="xml"> <viin_map res_partner="address_from_id" routing="true" waypoint_field="waypoint_ids" polyline_field="polyline"> <field name="waypoint_ids" /> <field name="polyline" /> <marker-popup> <field name="code" string="Mã"/> <field name="mapping_address" string="Hướng dẫn"/> </marker-popup> </viin_map> </field> </record>
Giải thích: - routing="true": Kích hoạt tính năng tuyến đường, cho phép hiển thị tuyến đường giữa nhiều waypoint trên bản đồ. - waypoint_field="waypoint_ids": Xác định trường chứa danh sách waypoint để tính toán tuyến đường. - polyline_field="polyline": Không bắt buộc. Nếu không khai báo, polyline sẽ được tự động tạo từ waypoint. - field name="waypoint_ids": Hiển thị tất cả waypoint trên bản đồ.
### Tự động tạo Polyline từ Waypoint
Khi bạn cấu hình tuyến đường mà không khai báo trường polyline, polyline sẽ tự động được tạo từ tọa độ của các waypoint.
Ví dụ:
<record id="view_route_route_map_auto_polyline" model="ir.ui.view"> <field name="name">route.route.viin_map.auto_polyline</field> <field name="model">route.route</field> <field name="arch" type="xml"> <viin_map res_partner="address_from_id" routing="true" waypoint_field="waypoint_ids"> <field name="waypoint_ids" /> <marker-popup> <field name="code" string="Mã"/> <field name="mapping_address" string="Hướng dẫn"/> </marker-popup> </viin_map> </field> </record>
### Các trường bắt buộc khi sử dụng Routing
Khi sử dụng routing="true", bạn cần khai báo: - waypoint_field: Định nghĩa waypoint cho tuyến đường. - res_partner: Bắt buộc trong tất cả các view viin_map.
Nếu không khai báo polyline_field, nó sẽ được tự động tạo từ waypoint.
Tùy chỉnh view bản đồ
Bạn có thể tùy chỉnh bản đồ bằng cách thêm hoặc sửa đổi các trường trong marker-popup hoặc thêm các thuộc tính khác vào thẻ viin_map.
Ví dụ về view tùy chỉnh:
<record id="view_custom_route_map" model="ir.ui.view"> <field name="name">route.route.custom_map</field> <field name="model">route.route</field> <field name="arch" type="xml"> <viin_map res_partner="address_from_id" routing="true" waypoint_field="waypoint_ids"> <field name="waypoint_ids" /> <field name="polyline" /> <field name="custom_field" string="Thông tin tùy chỉnh"/> <marker-popup> <field name="code" string="Mã"/> <field name="mapping_address" string="Hướng dẫn"/> <field name="custom_field" string="Thông tin thêm"/> </marker-popup> </viin_map> </field> </record>
Giải thích: - field name="custom_field": Thêm một trường tùy chỉnh vào view và hiển thị trong popup của từng marker.
Hỗ trợ
Nếu bạn cần hỗ trợ hoặc gặp vấn đề, vui lòng liên hệ Viindoo qua https://viindoo.com.
Phần mềm này và các tệp liên kết ("Phần mềm") được sử dụng (chạy, tuỳ biến, chạy sau khi được tuỳ biến) chỉ khi bạn mua được giấy phép có hiệu lực từ tác giả, điển hình như qua các Ứng dụng Odoo, hoặc trong trường hợp bạn nhận được thoả thuận bằng văn bản từ tác giả của Phần mềm (chi tiết tại tệp COPYRIGHT).
Bạn có thể phát triển các phân hệ Odoo có sử dụng Phần mềm như một Thư viện (thường là phụ thuộc vào, nhập vào và sử dụng nguồn của nó) nhưng không sao chéo bất kỳ mã nguồn hay tài liệu nào thuộc Phần mềm. Bạn có thể phân phối những phân hệ này theo giấy phép mà bạn lựa chọn, miễn sao nội dung giấy phép đó tương tích với điều khoản của Giấy phép Phần mềm Độc quyền Odoo (ví dụ: LGPL, MIT hay bất kỳ loại giấy phép phần mềm độc quyền nào tương tự vậy).
Nghiêm cấm phát hành, phân phối, cấp phép lại hoặc bán bản sao của Phần mềm hoặc bản sao Phần mềm đã được sửa đổi.
Thông báo bản quyền và chấp thuận nêu trên buộc phải được bao gồm trong tất cả các bản sao hoặc các phần quan trọng của Phần mềm.
PHẦN MỀM ĐƯỢC CUNG CẤP "NGUYÊN TRẠNG", KHÔNG BẢO ĐẢM DƯỚI BẤT KỲ HÌNH THỨC NÀO, ĐƯỢC THỂ HIỆN RÕ RÀNG HOẶC NGỤ Ý, KHÔNG GIỚI HẠN ĐẢM BẢO VỀ CÁC BẢO ĐẢM NGỤ Ý VỀ KHẢ NĂNG THƯƠNG MẠI, PHÙ HỢP VỚI MỤC ĐÍCH CỤ THỂ VÀ KHÔNG VI PHẠM. TRONG MỌI TRƯỜNG HỢP SẼ KHÔNG CÓ TÁC GIẢ HOẶC CHỦ SỞ HỮU BẢN QUYỀN NÀO CHỊU TRÁCH NHIỆM VỀ BẤT KỲ KHIẾU NẠI, THIỆT HẠI HOẶC TRÁCH NHIỆM PHÁP LÝ KHÁC NÀO TRONG PHẠM VI HỢP ĐỒNG, CÁC THIỆT HẠI HOẶC CÁCH KHÁC, PHÁT SINH TỪ, NGOÀI HOẶC CÓ LIÊN KẾT VỚI PHẦN MỀM HOẶC VIỆC SỬ DỤNG HOẶC KINH DOANH KHÁC TẠI PHẦN MỀM.
