You need three values. This page shows you exactly where to click. It takes about two minutes.Step 1: open the setup page#
If you are not signed in, the site sends you to Google sign-in first. Sign in and the setup page opens.Step 2: create an app#
Find the card named Your apps. Click New app.A small box asks for a name. Type anything you recognize later, for example My iOS app, debug. Click OK.Create one app per real app you ship. Do not reuse one app for your iOS and Android builds, because the dashboard reports usage per app.Step 3: copy the three credentials#
The page now shows your credentials. Copy all three.| Credential | What it is for | Keep it secret? |
|---|
client_key | Counts your monthly devices for billing | No, it ships inside your app |
sdk_key | Names your app to the lookup service | No, it ships inside your app |
sdk_secret | Signs your app's requests | Yes, treat it as a password |
The SDK secret is shown once. Copy it now and store it in your password manager. If you lose it, create a new app.Step 4: keep them out of your git history#
All three values end up inside your app binary, so a determined person can read them out of a shipped app. That is expected, and the server limits the damage. It checks every request against the app the credentials were issued to, so a credential copied into a different app stops working.Committing them to a public repository is still a bad idea. Anyone who finds them can spend your quota until you notice.Read them from your build configuration instead:Android: put them in local.properties or an environment variable, then inject them into the manifest with manifestPlaceholders.
iOS: put them in an .xcconfig file that git ignores.
Flutter and React Native: same as above, in the native folders.
What "sandbox" means on this page#
Your new app says sandbox. Sandbox is free, and lookups return real data. The only limit is 200 devices in a calendar month.Next#
Modified at 2026-08-18 21:41:35
