Skip to content

Multi-provider geocoding plugin supporting Nominatim, Google Maps, and Mapbox for automatic coordinate generation from addresses.

License

Notifications You must be signed in to change notification settings

FriendsOfBotble/fob-geocoding

Repository files navigation

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

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

Settings

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

Address Autocomplete

Contributing

See CONTRIBUTING.md

License

The MIT License. See License File

About

Multi-provider geocoding plugin supporting Nominatim, Google Maps, and Mapbox for automatic coordinate generation from addresses.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published