Files
voyage/documentation/docs/configuration/google_maps_integration.md
alex df8d1adf15 Rename AdventureLog to Voyage and add fork attribution
- Replace all AdventureLog references with Voyage across ~102 files
  (7 case variants: AdventureLog, adventurelog, Adventurelog, ADVENTURELOG,
  AdventUrelog, AdventureLOG, adventure-log, adventure_log)
- Rename brand, static, and documentation assets to use voyage naming
- Rename install_adventurelog.sh → install_voyage.sh
- Update README.md and voyage_overview.md to credit AdventureLog as
  the upstream project and Sean Morley as its original creator
2026-03-06 11:05:26 +00:00

2.0 KiB

Google Maps Integration

To enable Google Maps integration in Voyage, you'll need to create a Google Maps API key. This key allows Voyage to use Google Maps services such as geocoding and location search throughout the application.

Follow the steps below to generate your own API key:

Google Cloud Console Setup

  1. Go to the Google Cloud Console.
  2. Create an account if you don't have one in order to access the console.
  3. Click on the project dropdown in the top bar.
  4. Click New Project.
  5. Name your project (e.g., Voyage Maps) and click Create.
  6. Once the project is created, ensure it is selected in the project dropdown.
  7. Click on the Navigation menu (three horizontal lines in the top left corner).
  8. Navigate to Google Maps Platform.
  9. Once in the Maps Platform, click on Keys & Credentials in the left sidebar.
  10. Click on Create credentials and select API key.
  11. A dialog will appear with your new API key. Copy this key for later use.

Note

When creating the API Key, you can choose which APIs it can use. For versions v0.10.0 and lower, you need the Geocoding and Places APIs. For versions higher than v0.10.0, You'll need Geocoding and Places (New). Note that the latter isn't enabled by default!

Configuration in Voyage

Set the API key in your environment file or configuration under the backend service of Voyage. This is typically done in the docker-compose.yml file or directly in your environment variables .env file.

GOOGLE_MAPS_API_KEY=your_api_key_here

Once this is set, Voyage will be able to utilize Google Maps services for geocoding and location searches instead of relying on the default OpenStreetMap services.