Našeptáváč adres - Mapy.com / Google places

Novou verzi modulu stáhnete ve svém účtu v sekci Moduly a licence a nahrajete ji v administraci přes Moduly → Přidat nový modul. Stará verze se přepíše a data zůstanou zachována – modul předem neodinstalovávejte. Aktualizace jsou zdarma rok od nákupu.

Celý návod krok za krokem →

V administraci otevřete Moduly a služby → Přidat nový modul, vyberete ZIP soubor modulu a kliknete na Nahrát. Poté modul v seznamu najdete a stisknete Instalovat. Nahrát jej lze i přes FTP do složky modules, bezpečnější je ale instalace přes administraci.

Celý návod krok za krokem →

Modul přeložíte přímo v administraci: v seznamu modulů zvolíte u modulu možnost Přeložit, vyberete cílový jazyk, texty upravíte a uložíte. Pokud modul obsahuje vlastní e-maily, nakopírujte navíc přes FTP jazykové šablony e-mailů podle návodu.

Celý návod krok za krokem →

Samotný modul má jednorázovou cenu, provoz pak závisí na zvoleném poskytovateli adres:

Mapy.cz – registrace na developer.mapy.com je zdarma a bez platební karty. Služba poskytuje velkorysý bezplatný měsíční objem dotazů, do kterého se běžný e-shop bez problémů vejde. Pro obchody prodávající v ČR a na Slovensku je to tedy v praxi provoz zdarma.

Google Places – vyžaduje účet Google Cloud s vloženou platební kartou. Google poskytuje měsíční bezplatný objem a modul spotřebu aktivně šetří: všechny dotazy jedné rozepisované adresy spojuje do jedné účtované relace (tzv. session token) a výsledky si krátce pamatuje, takže se stejný dotaz neposílá dvakrát. Přesto doporučujeme spotřebu sledovat v Google Cloud konzoli, zejména u e-shopů s velkou návštěvností.

Aktuální ceníky a limity najdete přímo na webech služeb (developer.mapy.com, Google Cloud konzole) – mohou se v čase měnit.

Krátká odpověď: prodáváte-li hlavně v ČR a na Slovensku, zvolte Mapy.cz. Prodáváte-li do zemí, které Mapy.cz nepokrývají dostatečně, zvolte Google Places.

Poskytovatele můžete kdykoli přepnout v nastavení modulu – vyberete službu, vložíte její API klíč a uložíte. Nic dalšího se nemění, našeptávač pro zákazníky vypadá i funguje stejně.

Získání klíče je zdarma a zabere pár minut, platební karta není potřeba:

1. Otevřete developer.mapy.com a zaregistrujte se (stačí e-mail).
2. Po přihlášení otevřete Můj účet → Projekty a API klíče.
3. Založte nový projekt – název je libovolný, např. jméno vašeho e-shopu. U projektu se automaticky vytvoří API klíč.
4. Klíč zkopírujte a v administraci modulu ho vložte do pole API klíč. Jako poskytovatele nechte Mapy.cz a uložte.

Od této chvíle se našeptává. Stejný návod máte po ruce i přímo v nápovědě na záložce Nastavení modulu.

U Googlu je postup o něco delší, protože vyžaduje účet Google Cloud s platební kartou:

1. Otevřete console.cloud.google.com a přihlaste se Google účtem.
2. Založte projekt a v sekci Fakturace (Billing) k němu připojte platební kartu – bez ní Google mapové služby nezpřístupní.
3. V knihovně API (APIs & Services → Library) vyhledejte a povolte „Places API (New)“ – pozor, musí to být varianta s dovětkem „New“, starší „Places API“ modul nepoužívá.
4. V APIs & Services → Credentials vytvořte API klíč (Create credentials → API key).
5. Klíč zkopírujte, v administraci modulu vyberte poskytovatele Google Places, klíč vložte do pole API klíč a uložte.

Google poskytuje měsíční bezplatný objem dotazů; spotřebu doporučujeme sledovat v Google Cloud konzoli. Oficiální návod Googlu: developers.google.com/maps/documentation/places/web-service/get-api-key.

Nemůže – klíč nikdy neopustí váš server. Běžná řešení volají mapové API přímo z prohlížeče, takže klíč je viditelný v kódu stránky a kdokoli si ho může opsat a používat na vlastním webu na váš účet. Tento modul je postaven jinak: prohlížeč zákazníka se ptá vašeho e-shopu a teprve váš server se s klíčem ptá mapové služby. Klíč se navíc předává v HTTP hlavičce, ne v adrese požadavku, takže nezůstává ani v přístupových záznamech serverů.

Proti umělému protáčení dotazů (a tím spotřeby) je serverový endpoint chráněn několika pojistkami najednou:

• limit požadavků z jedné IP adresy za minutu – výchozích 60 běžného zákazníka nijak neomezí, roboty spolehlivě zastaví; hodnotu lze změnit,
• minimální délka dotazu – našeptává se až od nastaveného počtu znaků,
• kontrola původu požadavku – dotazy zvenčí, které nepřicházejí z vašeho e-shopu, se odmítají.

Mapové službě se posílá pouze rozepsaný text adresy – tedy to, co zákazník právě píše do adresního pole, a země, pro kterou se má hledat. Nikdy se neposílají žádné údaje o zákazníkovi (jméno, e-mail, telefon), o objednávce ani o vašem e-shopu. Modul si žádné dotazy ani vybrané adresy nikam neukládá.

Jde o stejný princip, jako když někdo hledá adresu v mapách na internetu. Vybraná adresa se uloží jen tam, kam ji zákazník sám odešle – do adresního formuláře vaší objednávky, přesně jako kdyby ji napsal ručně.

Se standardní šablonou a pokladnou PrestaShopu funguje hned po instalaci bez jakéhokoli nastavování – adresní pole si modul najde sám. Zvládá i dynamicky překreslované formuláře: AJAX pokladnu, přenačtení formuláře po změně země i modální okna v administraci. Pole si po překreslení znovu najde a rozepsanou práci …

Celý návod krok za krokem →

Nic dramatického – e-shop jede dál. Našeptávač je navržen jako pomocník navíc: když mapová služba neodpovídá, došel objem dotazů nebo je klíč neplatný, adresní formulář funguje úplně normálně, jen se nezobrazuje nabídka adres. Zákazník adresu prostě napíše ručně, jako by modul nebyl. Nikdy se nestane, že by zákazník kvůli výpadku služby nemohl dokončit objednávku.

Totéž platí pro pomalé odpovědi – našeptávání nikdy neblokuje psaní ani odeslání formuláře.

Nemusíte – modul si seznam zemí bere sám z nastavení vašeho obchodu (aktivní země v Mezinárodní → Lokace → Země). V nastavení modulu jen zvolíte režim:

• Podle země zvolené ve formuláři (doporučeno) – nabízejí se adresy ze země, kterou má zákazník ve formuláři právě vybranou. Dokud země známá není, použijí se všechny aktivní země e-shopu.
• Vždy aktivní země e-shopu – nabízí se vždy ze všech zemí, do kterých prodáváte, bez ohledu na výběr ve formuláři.

Když tedy do nabídky zemí e-shopu přidáte třeba Rakousko, začne se v něm automaticky i našeptávat – bez zásahu do modulu.

Ano. Modul má dva samostatné vypínače: front office (formuláře pro zákazníky – registrace, Můj účet, pokladna) a administrace (adresní formuláře back office – Zákazníci → Adresy a adresy objednávek). Můžete tedy našeptávat jen zákazníkům, jen sobě v administraci, nebo obojí.

V praxi to ocení každý, kdo zadává objednávky po telefonu nebo zakládá adresy zákazníků ručně – adresa se vyplní na pár úhozů a máte jistotu, že skutečně existuje.

Ano, na tohle modul myslí. PrestaShop kontroluje formát PSČ podle pravidel jednotlivých zemí – české PSČ vyžaduje ve tvaru s mezerou („736 01“), zatímco mapové služby ho vracejí bez mezery („73601“). Modul proto PSČ před vyplněním automaticky formátuje podle masky země nastavené v PrestaShopu, takže formulář projde validací na první uložení a zákazník žádnou chybu neřeší.

Funguje to pro všechny země podle jejich masek v PrestaShopu, ne jen pro ČR.

V nastavení vybíráte ze tří připravených vzhledů:

• Klasický – jednoduchý čistý seznam, ladí s každou šablonou,
• Moderní – dvouřádkové položky s ikonou špendlíku: ulice tučně, město s PSČ pod ní – vzhled známý z map,
• Tmavý – poloprůhledný tmavý panel pro e-shopy s tmavou šablonou.

Ve všech vzhledech se zvýrazňuje část textu, která se shoduje s tím, co zákazník napsal. Živé ukázky všech vzhledů najdete v souboru doc/navrhy-vzhledu.html ve složce modulu – stačí otevřít v prohlížeči. Pro jemné doladění (barvy, písmo) lze panel stylovat běžným CSS vaší šablony.

Na rychlost e-shopu má modul zanedbatelný vliv. Jeho skripty se vkládají jen na stránky s adresním formulářem (registrace, Můj účet, pokladna) – na produktech, v kategoriích ani na hlavní stránce modul nic nedělá. Jde o čistý JavaScript bez závislostí, žádné externí knihovny se nenačítají.

S dotazy na mapovou službu modul šetří hned několika způsoby: čeká na krátkou pauzu v psaní (neposílá dotaz po každém písmenu), překonané dotazy ruší, odpovědi si krátce pamatuje (stejný dotaz se neposílá dvakrát) a našeptává až od nastaveného počtu znaků. U Googlu navíc všechny dotazy jedné rozepisované adresy spojuje do jediné účtované relace.