Google Maps API Test Tool – Help Guide
Applies to: RP Promap + RP Local Pickup & Delivery
Last Updated: 2026
Overview
The Google Maps API Test Tool is a built-in diagnostic feature designed to instantly validate your Google Maps setup.
Instead of manually checking multiple APIs, billing settings, and configurations, this tool runs a comprehensive automated test and clearly shows what’s working—and what needs attention.
👉 This feature is available in:
RP Promap
RP Local Pickup & Delivery
Why This Matters
Google API misconfigurations are one of the most common causes of:
Maps not loading
Locations not appearing
Address lookup failures
Checkout delivery issues
The Test Tool eliminates guesswork by:
✅ Detecting setup issues instantly
✅ Confirming all required APIs are enabled
✅ Verifying billing configuration
✅ Preventing downtime and support escalations
How to Use the Test Tool
Go to: App → Settings → Google Maps API
Enter your Google Maps API Key
Click “Run Test”
Review the results:
✅ Green = Working correctly
⚠️ Warning = Needs attention
❌ Error = Action required
For RP Local Pickup and Delivery
Go to: App → Settings → General → Use Google Maps API (ensure this is toggled on)
Note: The Google API Integration is optional for RP Local Pickup and Delivery
Enter your Google Maps API Key
Click “Run Test”
Review the results:
✅ Green = Working correctly
⚠️ Warning = Needs attention
❌ Error = Action required
What the Test Checks
The tool validates all required services used across both apps:
1. Billing
Ensures your Google Cloud billing is active
Required for all Google Maps services
2. Geocoding API
Converts addresses → coordinates
Used for:
Store locator mapping (RP Promap)
Delivery address validation (Local Pickup & Delivery)
3. Maps JavaScript API
Loads and renders the interactive map
Core requirement for:
Store locator UI
Map display on storefront
4. Places API
Enables:
Address autocomplete
Location search suggestions
Critical for improving user experience at checkout and locator search
5. Distance Matrix API
Calculates distances between locations
Used for:
Delivery radius logic
Nearest store calculations
6. Geolocation API
Detects user location (browser/device-based)
Used for:
“Find nearest location” features
7. Places API (New)
Updated version of Places services
Ensures compatibility with newer Google features
Test Result Example
When everything is configured correctly, you’ll see:
✅ “Google Maps integration is fully configured. All required services are enabled and working correctly.”
Each service will show:
Status: Passed / Failed
Description: What’s working or what’s missing
Built for Ease of Use
This tool is designed to be:
One-click testing (no technical setup required)
Clear and visual (no debugging needed)
Self-service friendly (reduces reliance on dev teams)
Even non-technical users can:
Identify issues
Fix configuration problems
Get their maps working quickly
How This Reduces Errors & Support Issues
Before
Manual API setup
Hidden errors
Trial-and-error debugging
High support dependency
Now
Automated validation
Instant feedback
Guided fixes
Reduced support tickets
Role of Support Teams
The Test Tool empowers both merchants and support teams:
For Merchants
Self-diagnose issues
Fix setup without escalation
For Support Teams
Quickly identify root cause
Avoid back-and-forth troubleshooting
Standardize API validation process
Best Practices
Always run the test after adding or updating an API key
Ensure billing is enabled in Google Cloud
Enable all required APIs before going live
Re-run the test if maps or locations stop working
Need Help?
If any checks fail and you're unsure how to fix them:
Use the “Setup Google Maps API” link in the app
Or contact support with your test results screenshot
Summary
The Google Maps API Test Tool ensures:
✔ Faster setup
✔ Fewer errors
✔ Reliable map functionality
✔ Better customer experience
It’s your first line of defense against Google API issues across both RP apps.