# Google automatikus címkitöltés

> A Google címkitöltés bekapcsolása a pénztáron, a Places API verziói, a kitöltött mezők, az országszűkítés és a korlátozások.

A Google automatikus címkitöltésnél a vásárló az utcacím mezőbe kezd gépelni, a rendszer pedig címjavaslatokat kínál. A javaslat kiválasztása után a pénztár kitölti a többi címmezőt is. A vásárló továbbra is begépelheti a címet kézzel, ha így kényelmesebb, vagy ha a címe nincs a javaslatok között.

A funkció a fizetős csomagokhoz tartozik, érvényes licenccel, és a Google Places könyvtárát használja a saját Google API-kulcsoddal.

## Mi kell hozzá?

- Fizetős CheckoutWC csomag aktív licenccel. Az ingyenes változat nem tartalmazza.
- Google API-kulcs egy olyan Google Cloud projektből, amelyen a számlázás be van kapcsolva. A kulcs beszerzését [a Google API-kulcs fejezet](https://hub.hellowp.io/hu/plugins/checkout-for-woocommerce/cimkitoltes-google-api-kulcs/) írja le.
- A projekten engedélyezett **Maps JavaScript API**, és az a Places API-verzió, amelyet használni fogsz (lásd lent).

## Bekapcsolás

1. Nyisd meg a **CheckoutWC → Oldalak → Pénztár** fület.
2. A **Cím kitöltése és ellenőrzése** szakaszban jelöld be a **Google cím automatikus kitöltés engedélyezése** kapcsolót.
3. Kattints a **Módosítások mentése** gombra.
4. Nyisd meg a **CheckoutWC → Integrációk** oldalt, és a **Google API** szakaszban illeszd be a kulcsot a **Google API kulcs** mezőbe.
5. Válaszd ki a **Google Places API verziója** értékét.
6. Kattints a **Kulcs ellenőrzése** gombra, majd mentsd a beállításokat.
7. Nyisd meg a pénztárat, kezdj gépelni az utcacím mezőbe, és nézd meg, megjelennek-e a javaslatok.

![A Cím kitöltése és ellenőrzése szakasz a Pénztár beállításai között](./kepek/cimkitoltes-google-bekapcsolas.webp)

*A Cím kitöltése és ellenőrzése szakasz a Pénztár beállításai között* (https://minta-bolt.hu/wp-admin/admin.php?page=cfw-settings-checkout)

A képen a három címkitöltő beállítás látszik; a Google a legfelső.

A kulcs közös: ugyanaz működteti a köszönőoldal térképét is.

![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 kulcs mezője, a Places API verziója és a **Kulcs ellenőrzése** gomb látszik. A gomb addig szürke, amíg nincs kulcs a mezőben.

## Places API (új) vagy (régi)?

A **Google Places API verziója** mezőben két érték közül választasz: **Places API (új) - ajánlott** és **Places API (régi)**.

Válaszd az újat, hacsak a boltod nem fut már a régi API-n. A Google 2025. március 1-jén lezárta a régi Places API-t az újonnan létrehozott Google Cloud projektek előtt, ezért egy ennél újabb projekten csak az új verzió engedélyezhető. A kulcs mindkét verzióhoz jó, de a kiválasztott verziónak engedélyezve kell lennie a projekten, és ha korlátoztad a kulcs API-it, a kulcson is.

Az új telepítések az új verzióval indulnak. A korábban beállított boltok a régin maradnak, amíg át nem váltasz, magától semmi sem változik.

A javaslatok megjelenése a verziótól függ:

- **Régi verzió:** a Google saját legördülő listája jelenik meg a mező alatt.
- **Új verzió:** a CheckoutWC maga rajzolja a listát. Legalább három beírt karakter után kér javaslatot, és a lista nyílbillentyűkkel, Enterrel és Esc-cel is kezelhető.

## A kulcs kipróbálása

A **Kulcs ellenőrzése** gomb a böngésződből, ugyanúgy próbálja ki a kulcsot, ahogy a pénztár használja. Menthetsz előtte vagy utána is. Megmondja:

- hogy a Google elfogadja-e a kulcsot az oldaladon;
- hogy a kulcs eléri-e a Places API (új), a Places API (régi) és a Geocoding API (a köszönőoldal térképe) szolgáltatást;
- hogy a kiválasztott verzió működik-e;
- mi állítja még meg 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.

Ha a próba után megváltoztatod a kulcsot, frissítsd az oldalt, mielőtt újra ellenőrzöd: a Google Maps oldalanként csak egy kulcsot tölt be.

## Mely mezőket tölti ki?

A javaslatok az utcacím mezőben jelennek meg. Kiválasztáskor a pénztár kitölti:

- az utcacímet,
- a várost,
- az államot vagy megyét,
- az irányítószámot,
- az országot.

A **Cím 2** (lakás, emelet stb.) mezőt a legtöbb országnál törli, hogy ne maradjon régi lakásszám az új utca mellett. Az Egyesült Királyság, Új-Zéland és Tajvan esetén a Cím 2 a javaslat településrészéből kitöltődhet, és a mező ilyenkor láthatóvá válik. Ha a vásárlónak lakásszám kell, a javaslat kiválasztása után írja be.

A címkitöltés a szállítási címnél (ha a rendeléshez szállítás kell) és a számlázási címnél is működik, ugyanúgy.

## Javaslatok szűkítése országokra

Alapból a javaslatok nem szűkülnek országra. Ha csak néhány országba szállítasz, a szállítási és a számlázási javaslatokat külön szűrővel korlátozhatod. A szűrők kétbetűs országkódokat várnak (ISO 3166-1 alpha-2, kisbetűvel). Tedd a kódot egy kódrészlet-bővítménybe vagy a gyermektéma `functions.php` fájljába (ha a fájlban már van nyitó `<?php` jel, ne írd le még egyszer):

```php
add_filter( 'cfw_address_autocomplete_shipping_countries', function () {
	return [ 'hu', 'at' ];
} );

add_filter( 'cfw_address_autocomplete_billing_countries', function () {
	return [ 'hu', 'at' ];
} );
```

- Csak azt a szűrőt használd, amelyikre szükséged van.
- Az Egyesült Királyság kódja `gb`, nem `uk`.
- A **Places API (új)** legfeljebb 15 országot vesz figyelembe, a többit a CheckoutWC elhagyja. A **Places API (régi)** legfeljebb 5 országot fogad el.
- A szűrő csak azt változtatja meg, mit javasol a címkitöltés. A vásárló továbbra is begépelhet bármilyen címet, és kiválaszthat bármilyen országot, ahová a bolt szállít. Fetchify címkitöltésre nem vonatkozik.

## Mi nem működik vele együtt?

- A **Külön házszám és utcanév címmezők** és a Google címkitöltés nem használható együtt. A külön mezők bekapcsolása leállítja a címkitöltést. Ennek oka a kezelhetőség: egyik külön mezőbe sem értelmes beírni azt, ami alapján a címet keresni lehetne. Ha mindkettő kellene, a megoldás egy külön címkereső mező lenne, de az nincs a bővítményben, ezért válassz a két funkció közül.
- A Google és a Fetchify címkitöltés nem futhat egyszerre. Az egyiket kapcsold ki.
- Amíg a Google címkitöltés fut, a CheckoutWC saját irányítószám-kitöltése ki van kapcsolva. A Google javaslatának kiválasztása az irányítószámot és a várost együtt tölti ki.

## Gyakori kérdések

**Mobilon is működik?** Igen. Nincs külön mobilbeállítás vagy eszközellenőrzés: ugyanazokkal a beállításokkal, ugyanazzal a kulccsal és ugyanazokkal a javaslatokkal fut telefonon, mint számítógépen.

**Mennyibe kerül?** A CheckoutWC nem számít fel érte külön díjat, a fizetős csomagok tartalmazzák. A Google viszont a Google Cloud projektedre számlázza a pénztár kéréseit, ezért kell a projekten bekapcsolt számlázás. Az összeg a címkitöltést használó vásárlók számától és a Google aktuális díjaitól függ. Az új Places API-nál a CheckoutWC csökkenti a kérések számát: megvárja a három karaktert és egy kis szünetet, mielőtt javaslatot kér, és egy keresést egyetlen Google-munkamenetbe csoportosít. Ha a kulcsot a saját webhelyed domainjére korlátozod, azzal azt is megakadályozod, hogy más futtasson kéréseket a kulcsoddal.

**Ki kell tölteni kézzel is?** Nem. A vásárló figyelmen kívül hagyhatja a javaslatokat, és kézzel is kitöltheti a mezőket.

**Miért nem jelennek meg javaslatok?** Leggyakrabban a kulcs nincs engedélyezve az oldaladon, egy API nincs bekapcsolva a projekten, ki van kapcsolva a számlázás, vagy nem a projektnek megfelelő Places-verzió van kiválasztva. Először kattints a **Kulcs ellenőrzése** gombra, aztán nézd meg [a hibaelhárítási fejezetet](https://hub.hellowp.io/hu/plugins/checkout-for-woocommerce/cimkitoltes-google-hibaelharitas/).