Skip to main content

Google Maps Integration

Enable enhanced map features in your tags with Google Maps integration.

What Maps Enable​

In Tags​

  • Interactive map blocks
  • Location search
  • Directions links
  • Street View (coming soon)

Without Integration​

  • Basic maps still work
  • Limited functionality
  • OpenStreetMap fallback

Setting Up Google Maps​

1. Get API Key​

  1. Go to Google Cloud Console
  2. Create or select a project
  3. Enable these APIs:
    • Maps JavaScript API
    • Places API
    • Geocoding API
  4. Create credentials → API Key
  5. Restrict the key (recommended)

2. Configure in tagd-ai​

  1. Go to Settings → Integrations
  2. Click Google Maps
  3. Enter your API key
  4. Click Save
  5. Test by creating a map block

API Key Restrictions​

Secure your API key:

Application Restrictions:

  • HTTP referrers
  • Add: *.tagd-ai.com/*
  • Add your custom domain if applicable

API Restrictions:

  • Maps JavaScript API
  • Places API
  • Geocoding API

Features Enabled​

Search for locations by name:

  • Business names
  • Landmarks
  • Addresses
  • Points of interest

Autocomplete​

Type-ahead suggestions:

  • Fast address entry
  • Accurate locations
  • Reduced typos

Geocoding​

Convert addresses to coordinates:

  • Precise marker placement
  • Location validation

Directions​

Link to Google Maps directions:

  • Driving
  • Walking
  • Transit

Usage and Costs​

Free Tier​

Google provides $200/month credit:

  • ~28,000 map loads
  • ~40,000 geocoding requests
  • Usually sufficient for most users

Monitoring Usage​

  1. Go to Google Cloud Console
  2. Select your project
  3. View APIs & Services → Dashboard
  4. Monitor usage per API

Cost Management​

  • Set budget alerts
  • Review usage monthly
  • Optimize if needed

Troubleshooting​

Maps Not Loading​

  1. Check API key

    • Verify key is entered correctly
    • Check for extra spaces

  2. Check restrictions

    • Ensure tagd-ai.com is allowed
    • Verify APIs are enabled

  3. Check billing

    • Billing must be enabled
    • Check for quota exhaustion

"This Page Can't Load Google Maps"​

Usually means:

  • Invalid API key
  • Key restrictions too tight
  • Required APIs not enabled

Places Not Found​

  • Enable Places API
  • Check API restrictions
  • Try more specific search

Alternative: No Integration​

If you don't configure Google Maps:

  • Basic maps still work
  • Uses OpenStreetMap
  • Limited search capabilities
  • Free, no API key needed

Privacy Considerations​

What Google Receives​

  • Map tile requests
  • Search queries
  • IP addresses (from users)

What tagd-ai Stores​

  • Your API key (encrypted)
  • Location data in tags

User Privacy​

  • Consider GDPR implications
  • Update privacy policy if needed
  • Users' locations sent to Google

Next Steps​