FOB Geocoding

FOB Geocoding

Multi-provider geocoding plugin for Botble CMS. Supports Nominatim (free, no API key), Google Maps, and Mapbox for automatic coordinate generation from addresses.

Requirements

• Botble Core 7.5.0 or higher
• PHP 8.2 or higher

Compatible Scripts

• Flex Home
• Hously
• Homzen
• Jobcy
• JobBox

Installation

1. Extract the plugin to platform/plugins/fob-geocoding
2. Activate the plugin in Admin > Plugins
3. Configure in Settings > Others > FOB Geocoding

Providers

Nominatim (OpenStreetMap) - Default

• Free to use, no API key required
• Rate limited to 1 request per second (enforced server-side)
• Autocomplete via server-side proxy
• Good for basic geocoding needs

Google Maps

• Requires a Google Maps API key with Geocoding API enabled
• Uses Google Places Autocomplete widget (client-side)
• Best accuracy and coverage
• Get API Key

Mapbox

• Requires a Mapbox access token
• Client-side autocomplete via Mapbox API
• Good balance of accuracy and cost
• Get Access Token

Features

• Address Autocomplete: Suggestions appear as you type in the location field
• Get Coordinates Button: Click to geocode the entered address and fill lat/lng fields
• Server-side Caching: Geocoding results are cached to reduce API calls
• Admin Settings: Configure provider, API keys, and behavior from the admin panel

Usage

Once configured, the plugin automatically:

1. Adds a "Get Coordinates" button after the location field in property/listing forms
2. Enables address autocomplete on the location field
3. Fills in latitude and longitude fields when an address is geocoded

Contributing

See CONTRIBUTING.md

License

The MIT License. See License File