Automatické doplňování adres v objednávce - Google Places

Abyste mohli na svém e-shopu nabídnout zákazníkům automatické doplňování adres v objednávce pomocí služby Google Places, je nutné mít API klíč služby Google Maps Platform. API klíč se vytváří v prostředí Google Cloud Console po přihlášení ke Google účtu.

1. Přihlášení do Google Cloud Console, nastavení účtu a vytvoření projektu

1. Přihlaste se ke svému Google účtu a otevřete stránku Google Cloud Console:

• Na stránku Google Cloud Console se dostanete i přes URL adresu https://mapsplatform.google.com/, na které kliknete na tlačítko "Create an account":

• Případně stránku Google Cloud Console naleznete na adrese https://console.cloud.google.com

• Po úspěšném vytvoření účtu na Google Cloud Console se dostanete na stránku https://console.cloud.google.com/google/maps-hosted/build, na které je nutné případně dokončit nastavení účtu. Pokud ještě nemáte dokončené nastavení účtu Google Maps Platform, Google vás vyzve k jeho dokončení (Finish account setup).

Součástí tohoto kroku je:

• výběr platebního modelu
• přidání platební metody

Zvolte možnost Pay as you go (platba podle skutečného využití). Nejedná se o paušální tarif – platíte pouze za reálné využití API služeb. Pro běžné použití v e-shopu se náklady obvykle pohybují v rámci bezplatného měsíčního kreditu.

Po dokončení nastavení budete přesměrováni do prostředí Google Cloud Console.

2. V horní liště klikněte na výběr projektu a zvolte možnost Nový projekt (New Project) nebo v případě nového účtu My First Project.

Následně zvolíte organizaci, pokud je třeba, a kliknete na New project.

Projekt si pojmenujte (např. podle názvu e-shopu) a potvrďte jeho vytvoření přes tlačítko Create. Po vytvoření projektu se ujistěte, že je tento projekt aktivní.

2. Povolení potřebných API služeb

V rámci Google Cloud Console je třeba ověřit, že máte potřebné API služby aktivní. V levém tzv. hamburger menu tedy přejděte do části "APIs & services" > "Library", tedy do knihovny Vašich API služeb a postupně vyhledejte a povolte tyto služby:

• Places API
• Maps JavaScript API

Do nastavení Maps Javascript API / Places API se dostanete prokliknutím čtverce dané služby. Následně je nutné v jejím nastavení zvolit volbu ENABLE, tedy její povolení pro daný projekt:

Google vyžaduje při povolení API služeb pro daný projekt akceptování Podmínek evropského hospodářského prostoru, a to napsáním slova "Confirm" (Potvrzuji) a stisknutím tlačítka Accept & continue.

Po akceptování těchto podmínek a povolení daných služeb vždy obdržíte od Google nový API klíč, ten však nebudete používat.

3. Získání finálního API klíče

V předchozím kroku jsme si povolili všechny API, které bychom měli mít aktivní pro náš projekt, tedy Places API a Maps JavaScript API. Nyní si vytvoříme finální API klíč, který následně nastavíme v administraci Eshop-rychle. Finálním klíčem, který si vytvoříme, následně povolíme přístup ke všem potřebným API, které jsme si povolili.

1. V levém hamburger menu GCC si otevřete sekci APIs & Services a následně Credentials:

2. Klikněte na tlačítko Create credentials > API key. Google vám vygeneruje nový API klíč – ten si zkopírujte, budete ho potřebovat v administraci e-shopu.

4. Implementace API klíče v administraci Eshop-rychle

Vložení klíče provedete v administraci vašeho eshopu v sekci ESHOP > NASTAVENÍ E-SHOPU > OBJEDNÁVKOVÝ FORMULÁŘ - zde v dolní části stránky ve funkci Automatické dokončování adres. Změny v administraci nezapomeňte uložit!

Obecné doporučení, které obdržíte od Google, se týká zabezpečení tohoto klíče - zobrazuje se u něj žlutý trojúhelník. K tomuto klíči budete mít v Google Cloud Console přístup přes zmíněné hamburger menu - APIs & Services > Credentials - zde se prokliknutím daného klíče dostanete do jeho nastavení. Google doporučuje u klíče zvýšit zabezpečení (jeho restrikce) tím, že omezíte nějakým způsobem jeho možnosti užívání. Obecně je dobré klíč omezit například na konkrétní domény, aby jej nemohl využívat někdo další neoprávněně.

Po prokliknutí klíče tedy následně v jeho nastavení v části "Set and application restriction" vyberete Websites, o něco níže pak klikněte na ADD a do textového pole vyplníte vaši doménu, a to ve tvaru https://.mujweb.cz/. Klíč můžete používat i na více doménách, které zde ale pak nezapomeňte přidat. Nastavení těchto restrikcí je však libovolné a zcela na vás.

Kredit a upozornění

Abyste měli přehled, kolik kreditu máte vyčerpáno a dostávali případně i upozornění, když se přiblížíte vámi nastavené procentuální hranici, můžete se z administrace Google prokliknout do informací o vašem účtu a nastavit si vlastní rozpočet.

V levém menu zvolte "Budgets & alerts", následně vyberte "Create budget", vyplňte co je třeba a uložte.

Zároveň v záložce Overview najdete informace o čerpání a době, která zbývá pro platnost vašeho kreditu zdarma:

Aktualizováno dne: 09/01/2026