# Google API-kulcs beszerzése és beállítása

> Hogyan kérj Google API-kulcsot a címkitöltéshez és a köszönőoldal térképéhez, hogyan korlátozd, és hová told be.

Két funkcióhoz kell Google API-kulcs:

1. a [Google automatikus címkitöltéshez](https://hub.hellowp.io/hu/plugins/checkout-for-woocommerce/cimkitoltes-google-automatikus-kitoltes/) a pénztáron,
2. a térképhez a [köszönőoldalon](https://hub.hellowp.io/hu/plugins/checkout-for-woocommerce/beallitasok-koszonooldal/).

A kulcsot a Google Cloud Platformon (Maps Platform) kéred.

## A kulcs megszerzése

1. Nyisd meg a Google Maps Platform oldalát, és kattints jobb felül a **Get Started** (Kezdés) gombra.
2. Válaszd a **Maps** és a **Places** termékeket. A Maps a köszönőoldal térképéhez kell, a Places a címkitöltéshez. Általában mindkettőt érdemes kérni, de ha csak az egyik funkciót használod, elég az, amelyikre szükséged van.
3. Válassz egy meglévő projektet, vagy hozz létre újat.
4. Kapcsold be a számlázást a projekten. A legtöbb felhasználónak ez ingyenes marad, mert a Google havi keretet ad, de a számlázási kérdésekben a Google-lel kell egyeztetned. A lépések végén megkapod az API-kulcsot.
5. Kövesd a hivatkozást az API-konzolra.
6. Adj nevet a kulcsnak, és az **Application restrictions** (alkalmazáskorlátozás) alatt válaszd a **HTTP referrers** (webhelyek) lehetőséget. Így a kulcs csak a saját webhelyeiden használható. Ez fontos: ha a kulcs nincs korlátozva, valaki ellophatja és visszaélhet vele, a költség pedig a te számládon jelenik meg.
7. Ha az API-kat is korlátozni akarod, a kulcs listájában legyen ott a **Places API**, a **Maps JavaScript API** és a **Geocoding API**. Az új Places API-t használó boltnál a **Places API (New)** is.

## A kulcs megadása a CheckoutWC-ben

1. Nyisd meg a **CheckoutWC → Integrációk** oldalt.
2. A **Google API** szakaszban illeszd be a kulcsot a **Google API kulcs** mezőbe.
3. Válaszd ki a **Google Places API verziója** értékét ([erről a címkitöltés fejezete ír](https://hub.hellowp.io/hu/plugins/checkout-for-woocommerce/cimkitoltes-google-automatikus-kitoltes/)).
4. Kattints a **Kulcs ellenőrzése** gombra, majd a **Módosítások mentése** gombra.

![A Google API szakasz az Integrációk oldalon](./kepek/cimkitoltes-google-api-kulcs.webp)

*A Google API szakasz az Integrációk oldalon* (https://minta-bolt.hu/wp-admin/admin.php?page=cfw-settings-integrations)

A képen a **Google API kulcs** mező, a verzióválasztó és a **Kulcs ellenőrzése** gomb látszik.

## Ha valami nem működik

- Ha felkiáltójeleket látsz a címmezőben, nyisd meg a böngésző fejlesztői konzolját: a Google hibaüzenete megmondja, mi akadályozza az API-k betöltését.
- A leggyakoribb hiba, hogy a szükséges API-k (Maps, Places, Geocoding) nincsenek engedélyezve a projekten és a kulcson is. Mindkét helyen engedélyezni kell őket.
- A részletes hibalistát [a Google címkitöltés hibaelhárítása](https://hub.hellowp.io/hu/plugins/checkout-for-woocommerce/cimkitoltes-google-hibaelharitas/) tartalmazza.