> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.eshop-rychle.cz/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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":
![Google Maps Platform - Vytvoření účtu](https://storage.crisp.chat/users/helpdesk/website/-/6/f/3/2/6f32a7e5909e9400/2026-01-0910h4446_1q31grj.png)

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

|| Pro přihlášení do Google Cloud Console je nutné mít vlastní Google účet s dvoufázovým ověřením. Pokud ověření chybí, Google Vás bude navádět k jeho nastavení podle jeho aktuálních procesů.


* 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**. 

![Vytvoření nového projektu v rámci nového účtu](https://storage.crisp.chat/users/helpdesk/website/-/6/f/3/2/6f32a7e5909e9400/2026-01-0911h2005_1jtkzap.png)

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

![Další krok v rámci tvorby projektu v rámci organizace na Google Cloud Console](https://storage.crisp.chat/users/helpdesk/website/-/6/f/3/2/6f32a7e5909e9400/2026-01-0911h2549_1c49ncx.png)

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**

![API služby v rámci levého menu v GCC](https://storage.crisp.chat/users/helpdesk/website/-/6/f/3/2/6f32a7e5909e9400/2026-01-0911h3659_163bg9x.png)


![Vyhledávací pole v GCC, obvykle jsou Places API a Maps JavaScript API k dispozici v hlavní nabídce](https://storage.crisp.chat/users/helpdesk/website/-/6/f/3/2/6f32a7e5909e9400/2026-01-0911h4225_152q96x.png)

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:

![Povolení API služby pro konkrétní projekt v jejím nastavení](https://storage.crisp.chat/users/helpdesk/website/-/6/f/3/2/6f32a7e5909e9400/2026-01-0911h4752_1btitll.png)

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**. 

![Souhlas s Podmínkami evropského hospodářského prostoru pro daný projekt v GCC](https://storage.crisp.chat/users/helpdesk/website/-/6/f/3/2/6f32a7e5909e9400/2026-01-0911h5159_7ucluk.png)

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. 

![API klíč pro Google Maps](https://storage.crisp.chat/users/helpdesk/website/-/6/f/3/2/6f32a7e5909e9400/2026-01-0911h5606_cmw1qs.png)

---

## 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**:
![Credentials - Přístupy k API službám](https://storage.crisp.chat/users/helpdesk/website/-/6/f/3/2/6f32a7e5909e9400/2026-01-0912h1203_1ri1y69.png)

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.**

![Vytvořený finální API klíč k použití v administraci Eshop-rychle](https://storage.crisp.chat/users/helpdesk/website/-/6/f/3/2/6f32a7e5909e9400/2026-01-0912h1611_t9zeho.png)

---

## 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! 

![](https://storage.crisp.chat/users/helpdesk/website/6f32a7e5909e9400/image_1ue2ki8.png)


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ě.**

![](https://storage.crisp.chat/users/helpdesk/website/6f32a7e5909e9400/image_ysj70f.png)

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.

![](https://storage.crisp.chat/users/helpdesk/website/6f32a7e5909e9400/image_ttx50r.png)

---

## 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.

![](https://storage.crisp.chat/users/helpdesk/website/6f32a7e5909e9400/image_1m48gx4.png)

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:

![](https://storage.crisp.chat/users/helpdesk/website/6f32a7e5909e9400/image_14cvd5k.png)

