Podpora / Vaše mapa / Satelitní snímky Google Hledat v nápovědě
Satelitní snímky Google
Yardstick zobrazuje vaši zahradu nad bezplatným leteckým snímkem od státní instituce. Pokud dáváte přednost snímkům Google, které bývají ostřejší a novější, musíte zadat vlastní klíč Google. Tento návod vás provede celým postupem včetně dvou míst, kde lidé nejčastěji narazí.
Nejprve jedno úskalí
Google nyní nabízí bezplatný klíč bez nutnosti zadat platební kartu, nazvaný Maps Demo Key. Je opravdu zdarma a s Yardstick opravdu fungovat nebude. Narazí na to skoro každý, proto je dobré o tom vědět ještě před začátkem, ne až potom.
Yardstick používá Map Tiles API pro ostrý snímek ve vysokém rozlišení a Maps Static API jako záložní možnost. Zapněte obě API v projektu a povolte je také u svého klíče. Klíč, který povoluje pouze Maps Static, od verze Yardstick 1.1.10 stále zobrazí snímek v nižším rozlišení. Samotné zobrazení snímku tedy nepotvrzuje, že jsou mapové dlaždice povolené. Pokud se snímek při přiblížení rozmaže, zkontrolujte podle následujících kroků jak zapnutá API v projektu, tak omezení API u klíče. Fakturace musí být zapnutá ve stejném projektu, ke kterému patří klíč.
Pokud do Yardstick vložíte ukázkový klíč, mapa bude dál beze změny zobrazovat snímek USGS. Yardstick vám oznámí, že klíč nevrátil žádné snímky. Důležitý je ale důvod, proč ho Google odmítl, a řešení je vždy stejné: připojit fakturační účet.
Postup krok za krokem
Získejte klíč
Přejděte na Google Maps Platform a vytvořte si ukázkový klíč. V této fázi kartu nepotřebujete. Je to vhodný první krok, i když klíč zatím nebude fungovat.
Přečtěte si drobné písmo a stiskněte Upgrade account
Google vám poskytne klíč a zároveň uvede, že je omezený pouze na testování. Právě tato věta vysvětluje, proč nezobrazí vaši zahradu. Řešením je odkaz Upgrade account vedle ní.
Upgradujte účet
Google vysvětlí, co se změní: pro váš projekt se zpřístupní všechna jeho Maps API, stávající klíč bude dál fungovat a Google bude účtovat podle využití s měsíčním bezplatným limitem. Podívejte se na část o cenách níže.
Připojte fakturační účet
Pokud už fakturační účet máte, vyberte ho. Pokud ne, Google vás provede jeho vytvořením a požádá o platební kartu. Tento krok nelze obejít: Google vyžaduje zapnutou fakturaci u každého projektu, který používá snímky potřebné pro Yardstick. Google účtuje podle využití, viz část o cenách níže.
Nechte Google zapnout API za vás
Po dokončení upgradu Google znovu zobrazí váš klíč s již zaškrtnutou možností Enable all Google Maps APIs for this project. Nechte ji zaškrtnutou. Tím se zapnou Maps Static API i Map Tiles API a nebudete je muset hledat v konzoli.
Vložte klíč do Yardstick
Otevřete Nastavení, najděte Mapové podklady, nastavte zdroj na Google, vložte klíč a stiskněte Uložit. Poté znovu načtěte stránku s mapou.
Pokud jste klíč omezili
Omezení klíče je vhodné opatření a Yardstick funguje i s omezeným klíčem, pokud omezení povoluje obě API. Klíč omezený pouze na Maps Static API od verze Yardstick 1.1.10 zobrazuje záložní snímek v nižším rozlišení.
Zapněte Map Tiles API
V konzoli Google Cloud otevřete APIs & Services, poté Library, vyhledejte Map Tiles API a stiskněte Enable. Použijte stejný projekt, ke kterému patří váš klíč.
Přidejte ho do omezení API u klíče
Přejděte do APIs & Services, poté do Credentials a otevřete svůj klíč. V části API restrictions zkontrolujte, že jsou zaškrtnuté jak Maps Static API, tak Map Tiles API, a stiskněte Save.
Omezení aplikací ponechte beze změny
Omezení klíče na vaši vlastní veřejnou IP adresu je v pořádku: Yardstick odesílá požadavky službě Google z vašeho počítače. Omezení na weby (HTTP referrers) vhodné není a požadavky s ním budou vždy odmítnuty.
Počkejte několik minut a pak znovu načtěte stránku Přehled
Než Google změnu klíče uplatní, může to trvat několik minut.
Budete potřebovat fakturační účet
Google ho vyžaduje. Jeho dokumentace ke snímkům, které Yardstick používá, to uvádí jasně: „Chcete-li používat Maps Static API, musíte u každého svého projektu zapnout fakturaci a ke všem požadavkům API nebo SDK připojit klíč API nebo token OAuth.“
Tento požadavek nelze obejít ani bezplatným ukázkovým klíčem. Pokud fakturační účet ještě nemáte, vytvoříte ho v kroku Upgrade výše a budete muset zadat platební kartu.
Kolik to bude stát: využití a bezplatný limit
Google účtuje podle využití a pro každé API nabízí měsíční bezplatný limit. To, zda budete něco platit, závisí na míře využití a na tom, která API používáte.
Dřívější měření se týkalo jednoho pozemku s využitím uložených leteckých snímků: 20 snímků za 37 dní. Nelze z něj předpovědět využití Map Tiles API ani účet za jiný pozemek. Yardstick uchovává stažené letecké snímky na vašem počítači a znovu je používá, dokud uložená kopie vyhovuje. Map Tiles a Maps Static jsou samostatné služby, proto při kontrole projektu v Google Cloud sledujte jejich využití odděleně.
Dřívější výpočet založený na jednom novém snímku každé čtyři a půl minuty se týkal pouze snímků Static. Nelze z něj vyvodit, že se mapové dlaždice vejdou do svého limitu. Zkontrolujte obě API v Google Cloud a zahrňte i všechny další aplikace používající stejný fakturační účet.
Pokud překročíte bezplatný limit
Poplatky za využití nad bezplatný limit závisí na API a pásmu využití. Snímky Maps Static a požadavky Map Tiles mají různé fakturační jednotky i bezplatné limity. Ověřte si obojí v ceníku Google a pak sledujte využití svého projektu. Cenu snímků Static nepovažujte za cenu celé mapy.
Tyto ceny stanovuje a mění Google. Aktuální sazbu vždy najdete na jeho stránce s cenami.
Pokud mapa stále zobrazuje snímky USGS
Nejprve restartujte Yardstick
Ve verzi 1.0.5 a starších se uložený klíč začne používat až po restartování aplikace Yardstick. Pokud stále používáte tuto starší verzi, vyzkoušejte nejprve restart. Ve verzi Yardstick 1.1.10 klíč uložte a znovu načtěte mapu.
Ověřte, že klíč patří k účtu s aktivní fakturací
Ukázkový klíč fungovat nebude. Pokud jste neprovedli krok Upgrade, příčina je právě v tom.
Počkejte několik minut
Než Google začne obsluhovat nově zapnuté API, může to trvat několik minut. Sami jsme viděli, jak stejný klíč nejprve požadavek odmítl a o dvacet minut později ho bez problémů vyřídil, aniž bychom mezitím cokoli změnili.
Zkontrolujte, zda klíč není omezen na webové stránky
Yardstick posílá požadavky službě Google z vašeho počítače, nikoli z webové stránky. Klíč omezený na odkazující stránky HTTP bude vždy odmítnut.
Je snímek při přiblížení rozmazaný?
Klíč má povolený přístup k Maps Static API, ale ne k Map Tiles API. Viz výše Pokud jste klíč omezili.
Stále si nevíte rady? Pošlete nám protokol
V části Nastavení → Podpora → Něco nefunguje? stiskněte Odeslat diagnostiku do Yardstick. Stačí jedno kliknutí. Zjistíme tak, který zdroj byl požádán o snímky, který odpověděl a zda je uložený klíč. Samotný klíč se nikdy neposílá.
Zkontrolujte, zda je Map Tiles API zapnuté
Tři způsoby, jak to ověřit na straně Google i v aplikaci Yardstick.
V Google Cloud: je API zapnuté?
V konzoli Google Cloud otevřete APIs & Services a poté Enabled APIs & services. V seznamu by vedle Maps Static API mělo být i Map Tiles API. Pokud chybí, zapněte ho v části Library.
V Google Cloud: smí ho klíč používat?
Otevřete APIs & Services, poté Credentials a klikněte na svůj klíč. Pokud je u API restrictions nastaveno Restrict key, musí být ve výběru jak Maps Static API, tak Map Tiles API. Funguje i možnost Don't restrict key.
V aplikaci Yardstick: zůstává snímek na stránce Přehled ostrý?
Otevřete stránku Přehled a přibližte si svou zahradu. Pokud dlaždice fungují, snímek zůstává při přibližování ostrý a pod mapou je uveden Google jako zdroj. Od verze Yardstick 1.1.10 se při použití klíče pouze pro Maps Static API zobrazí jeden méně ostrý náhradní snímek.
V aplikaci Yardstick: přečtěte si odpověď od Google
V Nastavení v části Mapové podklady zapněte Ladění mapy (jen na žádost podpory), stiskněte Uložit a znovu načtěte stránku Přehled. Až si údaje přečtete, ladění opět vypněte. Je určené pro podporu a pod mapou zobrazuje panel. Tento panel obsahuje řádek tiles: on znamená, že Google poskytuje dlaždice; za refused následuje důvod přímo od Google, například "This API key is not authorized to use this service or API." Stejný řádek je i ve zprávě odeslané tlačítkem Odeslat diagnostiku do Yardstick.