Support / Je kaart / Satellietbeelden van Google Hulp doorzoeken
Satellietbeelden van Google
Yardstick tekent je tuin over een gratis luchtfoto van de overheid. Gebruik je liever de beelden van Google, die meestal scherper en recenter zijn, dan voeg je je eigen Google-sleutel toe. Deze handleiding neemt je overal in mee, ook langs de twee punten waarop mensen vaak vastlopen.
Eerst de valkuil
Google biedt tegenwoordig een gratis sleutel aan waarvoor geen creditcard nodig is: een Maps Demo Key. Die is echt gratis, maar werkt echt niet met Yardstick. Bijna iedereen loopt hier tegenaan, dus het is handig om dit te weten voordat je begint.
Yardstick gebruikt de Map Tiles API voor de scherpe foto met hoge resolutie en de Maps Static API als alternatief. Schakel beide in voor het project en sta beide toe voor je sleutel. Met een sleutel die alleen Maps Static toestaat, toont Yardstick vanaf 1.1.10 nog steeds een foto met lagere resolutie. Een zichtbare foto bewijst dus op zichzelf niet dat kaarttegels zijn ingeschakeld. Wordt het beeld wazig als je inzoomt, controleer dan zowel de ingeschakelde API's van het project als de API-beperkingen van de sleutel aan de hand van de stappen hieronder. Facturering moet zijn ingeschakeld voor hetzelfde project als waartoe de sleutel behoort.
Als je een demosleutel in Yardstick plakt, blijft de kaart gewoon de USGS-foto tonen. Yardstick meldt dat de sleutel geen beelden heeft opgeleverd, maar het gaat om de reden waarom Google de aanvraag weigert. De oplossing is altijd hetzelfde: koppel een factureringsaccount.
Stap voor stap
Vraag een sleutel aan
Ga naar Google Maps Platform en maak een demosleutel aan. Hiervoor heb je nog geen betaalkaart nodig. Dit is een prima begin, ook al werkt de sleutel nog niet.
Lees de kleine lettertjes en druk op Upgrade account
Google geeft je de sleutel en zegt er meteen bij dat die alleen voor testgebruik is. Die zin verklaart waarom je hiermee geen beelden van je tuin krijgt. De link Upgrade account ernaast is de oplossing.
Upgraden
Google legt uit wat er verandert: alle Maps-API's komen beschikbaar voor je project, je bestaande sleutel blijft werken en Google rekent af op basis van gebruik, met elke maand een gratis tegoed. Bekijk het gedeelte over prijzen hieronder.
Koppel een factureringsaccount
Heb je er al een, selecteer die dan. Zo niet, dan helpt Google je bij het aanmaken en vraagt het om een betaalkaart. Daar kun je niet omheen: Google vereist facturering voor elk project dat de beelden gebruikt die Yardstick nodig heeft. Google rekent af op basis van gebruik; zie het gedeelte over prijzen hieronder.
Laat Google de API's voor je inschakelen
Na de upgrade toont Google je sleutel opnieuw, met Enable all Google Maps APIs for this project al aangevinkt. Laat dit aangevinkt. Daarmee worden zowel de Maps Static API als de Map Tiles API ingeschakeld en hoef je ze niet zelf in de console op te zoeken.
Plak de sleutel in Yardstick
Open Instellingen, ga naar Kaartbeelden, stel de bron in op Google, plak de sleutel en druk op Opslaan. Laad daarna de kaartpagina opnieuw.
Als je beperkingen voor je sleutel hebt ingesteld
Het is verstandig om beperkingen voor een sleutel in te stellen. Yardstick werkt daar prima mee, zolang de beperkingen beide API's toestaan. Een sleutel die alleen de Maps Static API toestaat, levert vanaf Yardstick 1.1.10 een alternatieve foto met lagere resolutie op.
Schakel de Map Tiles API in
Open in de Google Cloud-console APIs & Services en daarna Library, zoek naar Map Tiles API en druk op Enable. Gebruik hetzelfde project als waartoe je sleutel behoort.
Voeg de API toe aan de API-beperkingen van de sleutel
Ga naar APIs & Services en daarna naar Credentials en open je sleutel. Zorg dat onder API restrictions zowel Maps Static API als Map Tiles API aangevinkt zijn en druk op Save.
Laat de toepassingsbeperking ongewijzigd
Je kunt de sleutel prima beperken tot je eigen openbare IP-adres: Yardstick doet de aanvragen bij Google vanaf je computer. Een beperking tot websites (HTTP-verwijzers) werkt niet en leidt altijd tot een weigering.
Wacht een paar minuten en laad de pagina Overzicht opnieuw
Het kan enkele minuten duren voordat Google een wijziging aan een sleutel doorvoert.
Je hebt een factureringsaccount nodig
Google stelt dit verplicht. In de eigen documentatie voor de beelden die Yardstick gebruikt, staat het duidelijk: "Om de Maps Static API te gebruiken, moet u facturering inschakelen voor elk van uw projecten en een API-sleutel of OAuth-token meesturen met alle API- of SDK-aanvragen."
Daar kun je niet omheen, ook niet met de gratis demosleutel. Heb je nog geen factureringsaccount, dan maak je er een aan tijdens de upgradestap hierboven. Daarbij wordt om een betaalkaart gevraagd.
Wat het kost: gebruik en gratis tegoed
Google rekent af op basis van gebruik, met een maandelijks gratis tegoed voor elke API. Of je betaalt, hangt af van je gebruik en de API's die je gebruikt.
De eerdere meting betrof één terrein waarvoor opgeslagen luchtfoto's werden gebruikt: 20 beelden in 37 dagen. Dit voorspelt niets over het gebruik van de Map Tiles API of de rekening voor een ander terrein. Yardstick bewaart gedownloade luchtfoto's op je computer en hergebruikt ze zolang de opgeslagen kopie geschikt is. Map Tiles en Maps Static zijn afzonderlijke diensten, dus bekijk hun verbruik apart wanneer je je Google Cloud-project controleert.
De oude berekening op basis van één nieuwe afbeelding per vier en een halve minuut had alleen betrekking op Static-afbeeldingen. Daarmee kun je niet vaststellen of kaarttegels binnen hun gratis tegoed blijven. Controleer beide API's in Google Cloud, inclusief eventuele andere toepassingen die hetzelfde factureringsaccount gebruiken.
Als je het gratis tegoed overschrijdt
De kosten boven het gratis tegoed hangen af van de API en de gebruiksschijf. Voor Maps Static-afbeeldingen en Map Tiles-aanvragen gelden verschillende factureringseenheden en gratis limieten. Controleer beide op de prijspagina van Google en houd daarna het verbruik van je project bij. De prijs voor Static-afbeeldingen is niet de prijs voor de hele kaart.
Dit zijn de prijzen van Google en Google kan ze wijzigen. Het actuele tarief vind je altijd op hun prijzenpagina.
Als de kaart nog steeds USGS toont
Start Yardstick eerst opnieuw op
In versie 1.0.5 en eerder wordt een opgeslagen sleutel pas gebruikt nadat Yardstick opnieuw is opgestart. Gebruik je nog zo'n oudere versie, probeer dan eerst opnieuw op te starten. In Yardstick 1.1.10 sla je de sleutel op en laad je de kaart opnieuw.
Controleer of de sleutel aan een factureringsaccount is gekoppeld
Een demosleutel werkt nooit. Heb je de stap Upgrade nog niet doorlopen, dan ligt het daaraan.
Wacht een paar minuten
Het kan enkele minuten duren voordat Google een pas ingeschakelde API beschikbaar maakt. We hebben meegemaakt dat een sleutel een verzoek weigerde en twintig minuten later probleemloos werkte, zonder dat er tussendoor iets was veranderd.
Controleer of de sleutel geen websitebeperking heeft
Yardstick doet verzoeken aan Google vanaf je eigen computer, niet vanaf een webpagina. Een sleutel die beperkt is tot HTTP-verwijzers wordt altijd geweigerd.
Wordt de foto wazig als je inzoomt?
De sleutel heeft toegang tot de Maps Static API, maar niet tot de Map Tiles API. Zie Als je je sleutel hebt beperkt hierboven.
Kom je er nog niet uit? Stuur ons het logbestand
Ga naar Instellingen → Ondersteuning → Is er iets mis? en klik op Diagnostische gegevens naar Yardstick sturen. Eén klik is genoeg. Zo zien we welke bron is opgevraagd, welke bron heeft geantwoord en of er een sleutel is opgeslagen. Je sleutel wordt nooit meegestuurd.
Controleer of de Map Tiles API is ingeschakeld
Drie manieren om dit te controleren, in Google en in Yardstick.
In Google Cloud: is de API ingeschakeld?
Open in de Google Cloud-console APIs & Services en daarna Enabled APIs & services. Map Tiles API hoort in de lijst te staan, naast Maps Static API. Ontbreekt deze, schakel de API dan in via Library.
In Google Cloud: mag de sleutel de API gebruiken?
Open APIs & Services, ga naar Credentials en klik op je sleutel. Als API restrictions is ingesteld op Restrict key, moeten zowel Maps Static API als Map Tiles API geselecteerd zijn. Don't restrict key werkt ook.
In Yardstick: blijft de foto op de pagina Overzicht scherp?
Open de pagina Overzicht en zoom in op je tuin. Als de kaarttegels werken, blijft de foto scherp tijdens het inzoomen en staat de bronvermelding van Google onder de kaart. Vanaf Yardstick 1.1.10 wordt bij een sleutel die alleen toegang heeft tot de Static API één minder scherpe foto als alternatief getoond.
In Yardstick: lees het antwoord van Google
Schakel in Instellingen onder Kaartbeelden de optie Kaartfoutopsporing (alleen op verzoek van ondersteuning) in, klik op Opslaan en laad de pagina Overzicht opnieuw. Schakel de optie weer uit zodra je de informatie hebt gelezen; deze is bedoeld voor ondersteuning en laat een paneel onder de kaart staan. Dat paneel bevat een regel tiles: on betekent dat Google kaarttegels levert; achter refused staat de reden die Google zelf opgeeft, zoals "This API key is not authorized to use this service or API." Dezelfde regel staat in het rapport dat je verstuurt met Diagnostische gegevens naar Yardstick sturen.