🛒 Bringo

Provider Guides

Google Cloud & Maps

One Google Cloud project gives you both your Maps keys and your Google Sign-In OAuth client. Do this once.

1. Create a project

  1. console.cloud.google.com → project dropdown → New Project.
  2. Name it (e.g. "MyStore") and create.
  3. Enable billing (Billing → link a card). Maps requires it; there's a generous free tier.

2. Enable the APIs

APIs & Services → Library → enable all six — each powers a different feature, so a missing one breaks only that feature and is easy to overlook:

  • Maps JavaScript API — website & admin maps
  • Maps Static API — order-tracking map image in the Customer & Delivery apps
  • Maps SDK for Android — native maps in the Android app builds
  • Maps SDK for iOS — native maps in the iOS app builds
  • Places API — address autocomplete (website loader + Customer app)
  • Geocoding API — address ⇄ coordinates ("use my location")
⚠️
Don't skip Maps Static API — without it the order-tracking / live-tracking screens in the Customer and Delivery apps show a map error (“This API is not activated on your API project”), even though address pickers and website maps work. See Google Maps → Troubleshooting.
🔔
Also in this console (but tied to your Firebase project): Firebase Cloud Messaging API (v1) — required for push notifications, normally enabled automatically when the Firebase project is created.

3. Create Maps keys

APIs & Services → Credentials → Create credentials → API key. Create separate keys and restrict each:

Web key
Restrict by HTTP referrers → your domain. Used for the admin "Map API Key".
Android key
Restrict by Android apps → package name + SHA-1.
iOS key
Restrict by iOS apps → bundle id.

4. Create the Google Sign-In OAuth client

For website Google login (and the app's idToken verification):

  1. OAuth consent screen → configure (app name, support email, your domain).
  2. Credentials → Create credentials → OAuth client ID → Web application.
  3. Authorized redirect URI: https://your-domain.com/account/auth/google/callback
  4. Copy the Web Client ID + Secret — used in Social Login and as the app's serverClientId.
🔗
For mobile Google Sign-In, the Android/iOS OAuth clients are created automatically when you add the apps in Firebase (Firebase uses this same Google Cloud project).
👉
Related: Google Maps integration · Firebase Project.