Klíč k mapě (Map Key, API Key) pro Google Maps
Napsal: 23 zář 2016 09:00
Všechny mapy, které jsou zobrazovány v TNG, pocházejí od Google Maps. Společnost Google zavedla v červnu 2016, přesněji 22.6.2016, nutnost získat Map Key (klíč k mapě), aby bylo nadále možné jejich mapy používat v jiných aplikacích. Přesněji je toto rozhodnutí popsáno na blogu vývojářů Google Maps.
Nové zásady byly okamžitě uplatněny na všech implementacích využívajících mapy od Google vytvořených 22.6.2016 a později. Stávajících aplikací (vytvořených před 22.6.2016) se tyto zásady netýkají z důvodu zachování jejich funkčnost i do budoucna. Pokud ve stávajících aplikacích dojde k nějakému zásadnímu nárůstu použití map, může Google v budoucnu kontaktovat i uživatele stávajících aplikací.
Z tohoto důvodu byl k TNG 11.0.1 vydán opravný patch, viz tento příspěvek, aby bylo možné do TNG zadat klíč k mapě a mapy se tak v nových implementacích TNG mohly řádně zobrazovat. Následující verze TNG 11.0.2 už má použití mapového klíče v sobě zakomponováno. Opraveny (nebo opravovány) na použití klíče k mapě jsou i všechny módy, které využívají mapy z Google Maps (např. World Map, Ancestor Map).
Řetězec Map Key se zadá do TNG>Administrace>Nastavení>Nastavení map. Výchozí hodnotou v poli Klíč k mapě je 1. To je pro situaci, že webové stránky s TNG byly vytvořeny před 22.6.2016, a klíč k mapě tudíž nepotřebují. Uživatel se tedy v tomto případě nemusí mapovým klíčem vůbec zabývat a hodnotu 1 v poli ponechá. Pokud však po 22.6.2016 vytvoří novou implementaci TNG, musí si vygenerovat Map Key a jeho hodnotu zadat do pole Klíč k mapě. Bez toho se mu na těchto nových stránkách nezobrazí žádná mapa.
Klíč k mapě je po zadání do TNG uložen v souboru mapconfig.php.
Získání klíče k mapě (Map Key, API Key)
Uživatel, který chce od Google získat klíč, musí být u Google registrován. Stačí, pokud má účet na Google Mail (http://www.gmail.com). Klíč k mapě lze pak získat na stránce Get a Key/Authentication.
Následuje přehled obrazovek, které se při této operaci zobrazí:
Klíč pro localhost
Pokud na svém počítači pro testování nebo ladění TNG používáte lokální webový server (WampServer, XAMPP), je třeba vygenerovat pro váš localhost další klíč. Opět použijeme stránku Get a Key/Authentication.
Následuje přehled obrazovek, které se při této operaci zobrazí:
Nové zásady byly okamžitě uplatněny na všech implementacích využívajících mapy od Google vytvořených 22.6.2016 a později. Stávajících aplikací (vytvořených před 22.6.2016) se tyto zásady netýkají z důvodu zachování jejich funkčnost i do budoucna. Pokud ve stávajících aplikacích dojde k nějakému zásadnímu nárůstu použití map, může Google v budoucnu kontaktovat i uživatele stávajících aplikací.
Z tohoto důvodu byl k TNG 11.0.1 vydán opravný patch, viz tento příspěvek, aby bylo možné do TNG zadat klíč k mapě a mapy se tak v nových implementacích TNG mohly řádně zobrazovat. Následující verze TNG 11.0.2 už má použití mapového klíče v sobě zakomponováno. Opraveny (nebo opravovány) na použití klíče k mapě jsou i všechny módy, které využívají mapy z Google Maps (např. World Map, Ancestor Map).
Řetězec Map Key se zadá do TNG>Administrace>Nastavení>Nastavení map. Výchozí hodnotou v poli Klíč k mapě je 1. To je pro situaci, že webové stránky s TNG byly vytvořeny před 22.6.2016, a klíč k mapě tudíž nepotřebují. Uživatel se tedy v tomto případě nemusí mapovým klíčem vůbec zabývat a hodnotu 1 v poli ponechá. Pokud však po 22.6.2016 vytvoří novou implementaci TNG, musí si vygenerovat Map Key a jeho hodnotu zadat do pole Klíč k mapě. Bez toho se mu na těchto nových stránkách nezobrazí žádná mapa.
Klíč k mapě je po zadání do TNG uložen v souboru mapconfig.php.
Získání klíče k mapě (Map Key, API Key)
Uživatel, který chce od Google získat klíč, musí být u Google registrován. Stačí, pokud má účet na Google Mail (http://www.gmail.com). Klíč k mapě lze pak získat na stránce Get a Key/Authentication.
Následuje přehled obrazovek, které se při této operaci zobrazí:
Klíč pro localhost
Pokud na svém počítači pro testování nebo ladění TNG používáte lokální webový server (WampServer, XAMPP), je třeba vygenerovat pro váš localhost další klíč. Opět použijeme stránku Get a Key/Authentication.
Následuje přehled obrazovek, které se při této operaci zobrazí: