Odoo Base Geolocalize - Geolocation
Automatic geolocation module for partner addresses and territory management
The Base Geolocalize module provides automatic geolocation capabilities for partner addresses in Odoo. This module integrates with Google Maps API to convert addresses into GPS coordinates (latitude/longitude), enabling distance calculation, map display, and sales territory management.
With Base Geolocalize, businesses can optimize delivery routes, allocate sales staff by geographic area, and provide better customer experience through location display on maps.
Basic Terminology
Geolocation Terminology
| Term | Vietnamese | Description |
|---|---|---|
| Geolocation | Định vị địa lý | Determining geographic location of addresses |
| Geocoding | Mã hóa địa lý | Converting addresses to GPS coordinates |
| Latitude | Vĩ độ | Latitude coordinate (North-South) |
| Longitude | Kinh độ | Longitude coordinate (East-West) |
| Distance | Khoảng cách | Distance between two geographic points |
| Territory | Vùng lãnh thổ | Assigned geographic area |
| Radius | Bán kính | Distance range from a point |
| IP Geolocation | IP Geolocation | Location detection from IP address |
Key Features
Base Geolocalize module provides comprehensive geolocation features:
Steps
1. Automatic geocoding for partner addresses
2. Google Maps API integration for accurate coordinates
3. Distance calculation between addresses
4. Display partner locations on interactive maps
5. IP address geolocation detection
6. Sales territory management by geography
7. Delivery route optimization
8. Search partners by geographic radius
Setup and Configuration
To use Base Geolocalize, configure Google Maps API:
Steps
1. Access Google Cloud Console and create new project
2. Enable Google Maps Geocoding API
3. Create API Key and set access restrictions
4. In Odoo: Settings → General Settings → Integrations
5. Enter Google Maps API Key in configuration field
6. Save configuration and test connection
Geocoding Partner Addresses
After API configuration, geocode partner addresses:
Steps
1. Open partner form: Contacts → Contacts → Select partner
2. Enter complete address: Street, City, Country
3. Click "Geolocalize" button or save address
4. System automatically calls Google Maps API
5. GPS coordinates (latitude/longitude) saved to partner
6. View location on map using "View on Map" button
Batch Geocoding
To geocode multiple partners at once:
Access: Contacts → Contacts
Steps
1. Select multiple partners to geocode
2. Click Action → Geolocalize
3. System processes each address sequentially
4. Check logs for results and errors
5. Invalid addresses will be skipped
6. Review successfully geocoded partners
Distance Calculation
Use GPS coordinates to calculate distance between addresses:
Steps
1. Both addresses need valid GPS coordinates
2. Use Haversine formula to calculate distance
3. Results returned in km or miles
4. Apply for delivery route optimization
5. Find nearest partner to a location
6. Allocate orders by distance
Territory Management
Use geolocation for sales territory management:
Steps
1. Define territories by center coordinates and radius
2. Assign sales staff to each territory
3. Automatically allocate partners to territories by address
4. Display territories on map
5. Report sales performance by geographic area
6. Alert when partner is outside assigned territory
IP Geolocation
Determine customer location from IP address:
Steps
1. Automatically detect location when customer visits website
2. Display region-appropriate content
3. Suggest nearest store or dealer
4. Auto-fill country/city in forms
5. Analyze traffic by geography
6. Detect fraud based on unusual locations
Google Maps Integration
Display and interact with Google Maps:
Steps
1. View partner location on interactive map
2. Display multiple partners with markers
3. Calculate and display optimal routes
4. View Street View for specific addresses
5. Search nearby places around partner
6. Embed maps in reports and dashboards
Real-world Use Cases
Practical scenarios for applying Base Geolocalize:
Delivery Optimization
Logistics company uses geolocation to:
Steps
1. Geocode all delivery addresses
2. Calculate shortest routes for drivers
3. Group orders by nearby areas
4. Estimate delivery time based on distance
5. Reduce fuel costs and transport time
6. Improve customer experience with on-time delivery
Sales Team Management
B2B business allocates customers to sales team:
Steps
1. Divide territories by province/city
2. Assign each salesperson to specific territory
3. Automatically allocate new leads by address
4. Display customer map for each sales rep
5. Plan customer visits by route
6. Evaluate performance by geographic area
Retail Store Chain
Store system uses geolocation to:
Steps
1. Display nearest store on website
2. Suggest pickup point based on customer location
3. Analyze coverage area of each store
4. Decide location for new store opening
5. Manage inventory by local demand
6. Marketing by specific geographic area
Customer Service
Technical service company optimizes dispatch:
Steps
1. Find nearest technician to customer
2. Estimate technician arrival time
3. Schedule maintenance by geographic route
4. Reduce travel time between appointments
5. Improve same-day resolution rate
6. Increase number of customers served
Common Error Handling
Common issues and solutions:
Invalid API Key Error
Steps
1. Check API Key entered correctly
2. Confirm Geocoding API is enabled
3. Check API usage limits (quota)
4. Ensure billing account is set up
5. Check IP restrictions if any
Coordinates Not Found
Steps
1. Check address is complete and accurate
2. Ensure sufficient information: street, city, country
3. Fix spelling errors in address
4. Try different address format
5. Enter coordinates manually if needed
Inaccurate Coordinates
Steps
1. Verify address on Google Maps
2. Update address with more details
3. Use specific house number and street name
4. Re-run geocoding after fixing address
5. Manually adjust coordinates if needed
Best Practices
Steps
1. Always enter complete and standardized addresses
2. Run batch geocoding during off-peak hours
3. Monitor Google Maps API quota usage
4. Cache coordinates to avoid repeated API calls
5. Validate coordinates before using for critical calculations
6. Use IP geolocation as fallback when no precise address
7. Periodically update coordinates for changed addresses
8. Set up alerts for geocoding errors
Integration with Other Modules
Base Geolocalize integrates with many Odoo modules:
Steps
1. Sales: Allocate opportunities by geographic territory
2. CRM: Manage pipeline by territory
3. Inventory: Optimize delivery routes from warehouse
4. Field Service: Dispatch technicians by location
5. Website: Display nearest store to customers
6. Marketing: Regional marketing campaigns
Access Rights
To use geolocation features:
Steps
1. Settings: Permission to configure Google Maps API
2. Partner Manager: Permission to edit partner addresses
3. Technical Features: Access to geocoding tools
4. Sales Manager: Permission to manage territories