# A Google címkitöltés hibaelhárítása

> Mit tegyél, ha a Google címkitöltés nem ad javaslatot: a kulcs ellenőrzése, a böngészőkonzol hibakódjai és a gyakori okok.

Ha a Google címkitöltés leáll, az ok szinte mindig a Google API-kulcs vagy a mögötte lévő Google Cloud projekt: a kulcsot nem engedik az oldaladon, egy szükséges API nincs bekapcsolva, nincs számlázás, vagy a CheckoutWC olyan Places API-verzióra van állítva, amelyet a projekted nem tud használni.

## Hogyan látszik a hiba?

- **Places API (régi):** ha gond van a kulccsal, a pénztáron a címmező mellett hibajelzés (felkiáltójel) jelenik meg.
- **Places API (új):** a címmező rendesnek látszik, de gépelésre nem jelennek meg javaslatok.

## 1. lépés: Kulcs ellenőrzése

Nyisd meg a **CheckoutWC → Integrációk** oldalt, és a **Google API** szakaszban kattints a **Kulcs ellenőrzése** gombra. A próba a böngésződből fut, ugyanúgy, ahogy a pénztár használja a kulcsot. Megmondja:

- elutasítja-e a Google a kulcsot az oldaladon;
- a kulcs a Places API (új), a Places API (régi) és a Geocoding API közül melyiket éri el;
- a kiválasztott Places-verzió működik-e a projekten, és ha nem, mit kell átállítani;
- mi állítja le a címkitöltést a CheckoutWC-ben: ki van kapcsolva a Google címkitöltés, be van kapcsolva a külön házszám és utcanév mező, vagy egyszerre be van kapcsolva a Fetchify.

A kulcsot mentés előtt is kipróbálhatod. Ha a próba után megváltoztatod, frissítsd az oldalt az újabb ellenőrzés előtt, mert a Google Maps oldalanként csak egy kulcsot tud betölteni.

## 2. lépés: a Google hibaüzenete a böngészőkonzolban

Nyisd meg a böngésző fejlesztői eszközeit a pénztároldalon, és nézd meg a konzolt. A hiba neve megmondja, mit javíts:

| Hibanév | Jelentése |
| --- | --- |
| `RefererNotAllowedMapError` | A webhelyed címe nincs a kulcs engedélyezett webhelyei között. A hiba kiírja, melyik címet kell engedélyezni. |
| `ApiNotActivatedMapError` | A Maps JavaScript API nincs engedélyezve a Google Cloud projekten. |
| `BillingNotEnabledMapError` | A projekten nincs bekapcsolva a számlázás. |
| `InvalidKeyMapError` | A Google nem találja a kulcsot, többnyire mert hiányosan másoltad be. |
| `ApiTargetBlockedMapError` | A kulcs API-korlátozásai között nincs ott egy szükséges API. |

A Places API (új) esetén a CheckoutWC a konzolba a „Google Places API (New) request failed” üzenetet is naplózza, ha a Google elutasít egy javaslatkérést. Ez általában azt jelenti, hogy a Places API (New) nincs engedélyezve a projekten, vagy nincs a kulcs engedélyezett API-i között.

## Gyakori okok és javításuk

1. **A kulcs nem engedélyezett ezen a webhelyen** (`RefererNotAllowedMapError`). A Google Cloud konzolban add hozzá a bolt domainjét a kulcs webhelykorlátozásaihoz.
2. **A kulcsnak nincs hozzáférése a szükséges API-khoz.** Ha korlátoztad a kulcs API-it, vedd fel a Maps JavaScript API-t, azt a Places API-t, amit a boltod használ (az újnál a Places API (New), a régi verziónál a Places API), és ha használod a köszönőoldali térképet, a Geocoding API-t.
3. **A projektnek nincs hozzáférése a szükséges API-khoz.** Engedélyezd a Maps JavaScript API-t és a használt Places API-t magán a Google Cloud projekten, és a térképhez a Geocoding API-t is.
4. **A Google Cloud projekten nincs számlázás.** Kapcsold be.
5. **A Places-verzió nem illik a projekthez.** A Google a régi Places API-t 2025. március 1-je után létrehozott projekteknek lezárta, ezért ott csak az új működik: a **CheckoutWC → Integrációk** oldalon állítsd a **Google Places API verziója** mezőt **Places API (új)** értékre, és gondoskodj róla, hogy az engedélyezve legyen a projekten.
6. **Be van kapcsolva a külön házszám és utcanév mező.** Ez kikapcsolja a Google címkitöltést, lásd [a Google címkitöltés fejezetét](https://hub.hellowp.io/hu/plugins/checkout-for-woocommerce/cimkitoltes-google-automatikus-kitoltes/).
7. **Egy teljesítményoptimalizáló bővítmény blokkolja a Google Maps betöltését** (például a PerfMatters, ha úgy állítottad be). A **Kulcs ellenőrzése** a felügyeleti felületen fut, nem a pénztáron, ezért átmehet a próbán akkor is, ha a bővítmény a pénztáron blokkolja a térképet.

Ha most állítasz be először kulcsot, a [kulcs beszerzéséről](https://hub.hellowp.io/hu/plugins/checkout-for-woocommerce/cimkitoltes-google-api-kulcs/) külön fejezet szól.