Tato sada nástrojů umožňuje geokódování, tedy hledání zeměpisné polohy daných míst. Sada obsahuje nástroje:

• Geocode CSV With Web Service,
• Geocode from Street Layer,
• Reverse Geocode. 

K vytvoření tohoto návodu dopomohly materiály od autora pluginu Michaela Minna (2021).

Geocode CSV With Web Service

Pro ukázku použití nástroje je využit soubor CSV s krajskými městy zakódovaný ve znakové sadě UTF-8. 

Po kliknutí na ikonu nástroje (MMQGIS > Geocode > Geocode CSV With Web Service) se zobrazí okno nástroje. 

V okně nástroje je třeba zvolit vstupní soubor CSV s adresami zakódovaný v UTF-8 (Input CSV File (UTF-8)). 

Dále je možné zvolit ze vstupního souboru CSV sloupce, které budou přidány do výstupního souboru jako atributy. K dispozici jsou 4 atributy: Address, City, State a Country. Před spuštěním pluginu je vhodné prostudovat soubor CVS, aby bylo možné jednotlivé sloupce CSV správně přiřadit k dostupným atributům. Není nutné vyplňovat všechny atributy.    

Rovněž je potřeba zvolit webovou geokódovací službu, pomocí níž bude možné geokódovat místa vypsaná v CSV souboru (Web Service). K dispozici jsou možnosti Google, OpenStreetMap / Nominatim, US Census Bureau, ESRI Server, NetToolKit. Webové služby obsahují odlišné geodatabáze, výstupy se tedy mohou mírně lišit. 

 V případě volby možnosti Google či NetToolKit je třeba zadat API klíč, tedy identifikátor používaný k autorizaci uživatele (Google API Key). 

Dále je potřeba zvolit způsob určení a zobrazení výsledků (Duplicate Results Handling). K dispozici jsou možnosti:

• Use Only First Result: bude použit pouze první nalezený výsledek, 
  
• Multiple Features for Multiple Results: budou použity všechny případně nalezené výsledky, tyto výsledky budou v atributové tabulce očíslovány. 
  

Poté stačí zvolit název nového souboru a jeho umístění v adresáři (Output File Name). Rovněž je nutné zvolit název nového CSV souboru, který bude obsahovat vstupní adresy, jež nebylo možné geokódovat a jeho umístění v adresáři (Not Found Output List). V posledním kroku stačí kliknout na Apply. 

Jelikož geodatabáze webových geokódovacích služeb mohou obsahovat nepřesná data, je vhodné výstupy zkontrolovat. To je možné provést např. porovnáním dat atributové tabulky vytvořeného souboru a dat z původního CSV souboru. V případě, že v atributové tabulce chybí některé adresy uvedené ve vstupním CSV souboru, pravděpodobně nebylo adresy možné geokódovat a budou vypsány v novém CSV souboru s nevyhledatelnými adresami (Not Found Output List). Výsledky je rovněž možné zkontrolovat pomocí podkladové mapy, tu je do projektu možné vložit např. pomocí pluginu QuickMapServices či po kliknutí na Layer > Add Layer > Add WMS/WMTS Layer / Add XYZ Layer apod.  

Po instalaci pluginu (viz podkapitola Stažení a instalace pluginů) se QuickMapServices objeví v položce Web v panelu nástrojů v horní části obrazovky. Ikonka pluginu se rovněž objeví v panelu Vector Toolbar. Po kliknutí na ikonu nástroje (Web >  QuickMapServices) stačí zvolit požadovanou podkladovou mapu.

V tomto případě byla geokódována krajská města ČR pomocí služby OpenStreetMap / Nominatim. Byla zvolena možnost Multiple Features for Multiple Results, k některým adresám bylo nalezeno více výsledků jejich umístění. Všechny adresy byly geokódovány, soubor Not Found Output List tedy zůstal prázdný. Špatně geokódované či nadbytečné výsledky by bylo vhodné odstranit. 

K nalezeným prvkům byly jako atributy přidány sloupce z CSV tabulky (id, město, kraj) a také další doplňujcí informace o daném místě, které byly v geodatabázi dostupné (počet výsledků k daným prvkům (result num), id OSM prvku, přesná adresa, kategorie a typ objektu nacházející se na dané adrese, souřadnice). Jelikož byla zvolena možnost Multiple Features for Multiple Results a k některým adresám bylo nalezeno více výsledků, ve sloupci result_num jsou jednotlivé možnosti očíslovány. Např. pro Karlovy Vary bylo nalezeno 10 výsledků. Špatně geokódované či nadbytečné výsledky by bylo vhodné odstranit. 

Geocode from Street Layer

Nástroj slouží ke geokódování adres ze souboru CSV pomocí mapové vrstvy ulic. CSV soubor by měl být zakódován ve znakové sadě UTF-8, měl by obsahovat sloupce s názvy ulic a dalšími doplňující atributy. Vrstva ulic by měla být představována středovými osami ulic, jednotlivé prvky (ulice) by měly obsahovat atributy definující rozsah ulice, resp. rozsah adres spojených s danou ulicí. Názvy ulic v mapové vrstvě ulic se musí přesně shodovat s názvy v CSV souboru! Jestliže jsou součástí názvu ulice čísla, pomlčky, lomené čáry a další podobné znaky, pravděpodobně se názvy z CSV souboru a vrstvy ulic nebudou shodovat. (MINN 2021)

Tento nástroj bude v dalších verzích nejspíše rozšířen, propojování souborů CSV a mapových vrstev ulic by mělo být více optimalizované. (MINN 2021) V současnosti je však nástroj vhodný pouze pro precizně zpracovaná data, pro běžně dostupná data se použití nástroje nehodí, výsledky jsou nepřesné. Z tohoto důvodu nebude nástroj více rozebírán. V případě zájmu se doporučuje počkat na novější verzi pluginu :). 

Reverse Geocode

Pro ukázku použití nástroje jsou využita upravená vektorová data ObceBody z databáze ArcČR500 (2016). 

Po kliknutí na ikonku nástroje (MMQGIS > Geocode > Reverse Geocode) se zobrazí okno nástroje.

V okně nástroje je třeba zvolit mapovou vrstvu, k jejímž prvkům mají být připojeny atributy z webové služby (Input Layer Name). Rovněž je potřeba zvolit webovou službu, pomocí níž bude zpětné geokódování provedeno (Web Service). K dispozici jsou možnosti Google a OpenStreetMap / Nominatim. V případě volby možnosti Google je třeba zadat API klíč, tedy identifikátor používaný k autorizaci uživatele (Google API Key).

Dále je potřeba zvolit způsob určení výsledků (Duplicate Results Handling). K dispozici jsou možnosti:

• Use Only First Result: k prvkům bude přidán pouze první nalezený výsledek, 
  
• Multiple Features for Multiple Results: k prvkům budou přidány všechny případně nalezené výsledky. 
  

V posledním kroku stačí zvolit název nového souboru a jeho umístění v adresáři (Output File Name) a kliknout na Apply. 

V tomto případě byla zpětně geokódována krajská města ČR pomocí služby OpenStreetMap / Nominatim. Na základě jejich umístění k nim zvolená webová služba přidala další atributy (počet výsledků k daným prvkům, ID, přesná adresa, kategorie a typ objektu nacházející se na dané adrese, souřadnice) . V případě, že by byla zvolena možnost Multiple Features for Multiple Results a bylo by nalezeno více výsledků, ve sloupci result_num by byly dané výstupy očíslovány. Přebytečné body by bylo vhodné odstranit. Jelikož geodatabáze webových služeb nemusí obsahovat zcela relevatní data, je vhodné provést kontrolu výsledků.