beDots Meridian — Place intelligence (PHP)
==========================================

Setup
-----

1. Copy `config/config.example.php` to `config/config.php`.

2. In Google Cloud Console:
   - Create a project (or pick one).
   - Enable billing.
   - Enable "Places API (New)".
   - Create an API key; restrict it to Places API (New). For local WAMP you may use no IP restriction during development only.

3. Paste the key into `config/config.php` as `google_places_api_key`.

4. Open the app in your browser, for example:
   http://localhost/mapsv2/public/
   (adjust the path if your WAMP document root or alias differs.)

Usage
-----

- Enter place keywords (e.g. tourist attractions) and location (e.g. Muscat, Sultanate of Oman).
- Use the primary action on the page to run a query. Up to several pages of results are loaded (with pauses required by Google between pages).
- Use Export CSV / Download spreadsheet to save UTF-8 CSV with a BOM so Excel shows Arabic and other scripts correctly.

Notes
-----

- The API key must stay server-side in `config/config.php`; do not commit that file (see `.gitignore`).
- This uses Google's Places API (New) Text Search, which complies with Maps Platform terms.