Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

Help for owners

The map in my app is blank, or my maps bill jumped

Short answer

A blank map in an app is usually a key or account problem, not a design problem. Google requires an API key on every Maps call, a project with billing enabled, and the Maps SDK switched on in that project. Check those three in your Google Cloud account first, then ask a developer to look at how the key is restricted.

  • Written for business owners
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Does this sound like your situation?

  • The map screen in my app is grey, empty or only shows the Google logo.
  • Maps worked before and stopped after my developer left or my card changed.
  • The map works in the test version but not in the version from the store.
  • The Google Maps charge on my account is higher than I expected.
  • Only some users or some phones see a blank map.

Why does this happen?

  1. The app has no valid API key

    Google Maps Platform products are protected from unauthorized use by requiring an API key on every call. If the key was deleted, replaced or never added to the released version of the app, the map has nothing to load.

  2. Billing is not active on the Google Cloud project

    Setting up Maps needs a Google Cloud project with billing enabled. If the card expired or the billing account was closed or moved, the project can stop serving maps even though nothing in the app changed.

  3. The Maps SDK is not switched on for the project

    Before the Maps SDK for Android can be used, it has to be enabled in the Google Cloud project through the console. A key from a new or different project does not carry that setting with it.

  4. The key is restricted to the wrong app

    Google lets a key be limited to specific websites, IP addresses or apps. If the limit names the wrong app, your own app is treated as an outsider, so the restriction is worth checking against the released version.

  5. Usage is counted across the whole billing account

    Google adds up usage for all projects linked to one billing account for the month, and each type of call has its own free monthly allowance. Because the total is added up across projects, it is worth listing every project on the account.

What can I do about it today?

  1. Find out whose Google Cloud account holds the keyAsk who created the Maps key. If it sits in your developer's personal account, note that and ask for access to be added for you as an owner.
  2. Check that billing is activeOpen the project in Google Cloud and look at the billing page. An expired card or a closed billing account is the simplest cause, and you can fix it without touching the app.
  3. Look at the usage reportThe Maps usage page shows which type of call is being used most. Take a screenshot and send it to your developer, it saves a lot of guessing.
  4. Do not delete keys or projectsRemoving a key breaks every version of the app that uses it, including the ones already installed on phones. Leave them in place until someone has checked.
  5. Write down what changed recentlyA new phone model, a new app version, a changed card or a new developer. The first change after the last good day is usually the cause.

When should I bring someone in?

  • Billing is active and the map is still blank.
  • The charge keeps growing and you cannot tell which app or screen causes it.
  • Nobody on your side can open the Google Cloud project.

How do I handle it?

  1. Check the account side firstI look at the project, billing state, enabled services and how the key is restricted, with you or your account owner sharing the screen. I do not need your password.
  2. Match the key to the released appI compare what the store version of the app uses against the key settings, because a test build and a store build often differ.
  3. Find where the calls come fromI read the usage breakdown to see which screens, features or apps make the calls, and list the ones that are not needed.
  4. Fix and confirm on real phonesI make the change, then check the map on a real phone from the store version, not only on a test device.

The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.

What do owners ask about this?

Do I need to pay Google to show a map?

Google Maps Platform setup requires a project with billing enabled, and Google lists a free monthly allowance for each type of call. What you owe depends on your usage, so check the pricing page and your own usage report.

Will a new key break the app already on phones?

Yes, it can. Installed versions carry the old key, so replacing it means releasing an update. Plan that before removing anything.

Why does the map work for me but not for customers?

Often the key is restricted to certain apps or the store build differs from the test build. Checking the restriction against the released app is the first step.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.

Next step

Want this off your desk?

Send me a few lines on where things stand. I reply within 24 hours.