Getting a Google key for Street View
By default, FranceJadis's “Today” panel shows the Apple Look Around
view, with nothing to set up. If you prefer Google Street View
(often available in more villages), Google requires each user to use their own
“key”: a personal code of about forty characters, starting with AIza.
This page explains how to get one, step by step, with no technical knowledge.
Before you start
- You need a Google account (a Gmail address is enough).
- Google asks you to register a bank card. Every month, Google offers a free usage allowance, far more than enough for personal use of FranceJadis. Step 6 shows how to set a limit so that you never pay anything.
- Allow 10 to 15 minutes. Preferably do it on a computer: Google's screens are not very practical on a phone.
Google regularly changes the look of its console: button names may differ slightly from those given here. The principle stays the same.
Which key for which device?
| You use FranceJadis… | Service to enable | Key restriction |
|---|---|---|
| in a browser (francejadis.fr) | Maps JavaScript API | Websites: https://francejadis.fr/* |
| on a Mac (app) | Maps JavaScript API | Websites: https://plantes.lespotagers.fr/* |
| on an iPhone or iPad (app) | Maps SDK for iOS | iOS apps: fr.lespotagers.FranceJadis.FranceJadis |
The same key can be used for the browser and the Mac: just add both addresses in step 5. For the iPhone and iPad, create a second key (repeat steps 4 to 6), because Google allows only one type of restriction per key.
Open the Google Maps Platform console
Go to console.cloud.google.com/google/maps-apis/start and sign in with your Google account. Accept the terms of service if you are asked to.
Create a project
Google keeps everything in “projects”. If asked, create one (New
project button at the top of the page) and name it, for example,
FranceJadis. Leave the other fields as they are, then
Create.
Register a payment method
Google then shows a “Billing account” screen. Enter your country, tick “Individual” if that choice is offered, then enter your card. Nothing is charged as long as you stay within the free monthly allowance (see step 6 to lock this in).
Enable the service and create the key
- ☰ menu at the top left → APIs & Services → Library.
- Search for Maps JavaScript API (browser or Mac) or Maps SDK for iOS (iPhone / iPad), open it and click Enable.
- ☰ menu → Google Maps Platform → Keys & Credentials (or APIs & Services → Credentials) → Create credentials → API key.
- The key is shown (
AIza…). Copy it and keep the window open.
Protect the key (important)
An unprotected key could be reused by someone else, at your expense. Click the key's name (or Edit API key):
- Application restrictions:
- browser or Mac: choose Websites, then Add the address given in the table above (both if you use both);
- iPhone / iPad: choose iOS apps and add
fr.lespotagers.FranceJadis.FranceJadis.
- API restrictions: choose Restrict key and tick only the service enabled in step 4.
Click Save. It can take up to 5 minutes to take effect.
Set a limit so you never pay (recommended)
- ☰ menu → APIs & Services → Enabled APIs & services → click the enabled service.
- Quotas & System Limits tab: find the line for requests
per day, click the pencil and enter a modest limit, for example
100. - Optional: ☰ menu → Billing → Budgets & alerts → create a €1 budget to be warned by email at the slightest cost.
Prices and the free allowance are published by Google at mapsplatform.google.com/pricing.
Enter the key in FranceJadis
- Open the toolbar → gear icon Settings.
- In the Street section, choose Street View.
- Paste the key into the Google key field (in the app: Google activation key) and tap OK.
- Restart the app (or reload the page in the browser) if you are asked to.
The key is stored only on your device (Apple Keychain, or this browser). It is never sent to the FranceJadis server.
Troubleshooting
- “Street View unavailable here (or Google key refused)”: check that the right service is enabled (step 4), that the address or identifier from step 5 is written exactly as shown, that the payment method is registered, then wait 5 minutes.
- Black or empty picture: Google may have no view at this spot. Try another postcard, or go back to Look Around.
- You no longer want a key: in the console, delete the key or disable billing for the project. FranceJadis then switches back to Apple Look Around.
FranceJadis