# Beállítás

> A geolokáció bekapcsolása: API-kulcs, mezőcsoport-beállítások és a címjavaslatok szűrése.

A működéshez négy dolgot kell beállítani:

1. a geolokációs szolgáltatás (API) elérését,
2. a mezőcsoport beállításait,
3. a címmezőt, amely a javaslatokat kéri,
4. a többi mezőt, amelyek a kiválasztott címből töltődnek.

Az első kettőt ez a fejezet, az utolsó kettőt a [Mezők és címrészek](https://hub.hellowp.io/hu/plugins/meta-box-geolocation/mezok/) fejezet írja le.

## A szolgáltatás elérése

### Google Maps

1. A Google Cloud Platform konzoljában hozz létre egy projektet.
2. Engedélyezd a projektben ezeket az API-kat: **Google Maps API**, **Geocoding API**, **Places API**.
3. Hozz létre egy API-kulcsot a Google Maps számára. Ezzel a kulccsal megy minden hívás a Google szolgáltatása felé.

### Open Street Maps

Nincs teendő: az Open Street Maps nem kér kulcsot és beállítást.

## A mezőcsoport beállításai

A geolokációt mezőcsoportonként kell bekapcsolni a mezőcsoport **egyéni beállításai** (custom settings) között.

### Open Street Maps

Vegyél fel a mezőcsoportba egy **Open Street Maps** típusú mezőt. Ezután a mezőcsoport egyéni beállításai közé add hozzá a `geo` kulcsot `true` értékkel.

MB Builderben ez a mezőcsoport beállításainak **Advanced** paneljén, a **Custom settings** listában található: a **+ Add New** gombbal új sort veszel fel, az első mezőbe a kulcsot (`geo`), a másodikba az értéket (`true`) írod.

Kódból:

```php
'geo' => true,
```

### Google Maps

Google Maps esetén nem kötelező **Google Maps** típusú mezőt felvenni a mezőcsoportba. A geolokációt a `geo` egyéni beállítás kapcsolja be, az értéke az API-kulcsot tartalmazó lista. MB Builderben a `geo` kulcs értékébe a JSON-jelölést használhatod, vagy pontjelöléssel külön sorokban adod meg a beállítást (például `geo.api_key`).

Kódból:

```php
'geo' => [
    'api_key' => 'AZ_ON_API_KULCSOD',
],
```

Ha a mezőcsoportban van **Google Maps** típusú mező, az API-kulcsot elég egyszer megadni: vagy a geolokáció beállításában, vagy a térképmezőnél. Nem kell mindkét helyen ugyanazt a kulcsot beírnod.

## Javaslatok szűrése

A `geo` beállításban további opciókat is megadhatsz.

| Opció | Mit csinál |
|---|---|
| `types` | A javaslatok típusainak listája (lásd lent). |
| `componentRestrictions` | A javaslatokat egy országra szűkíti. Az országot kétbetűs ISO 3166-1 Alpha-2 kóddal add meg, például `hu`. |

A `types` lehetséges értékei:

| Érték | Eredmény |
|---|---|
| `geocode` | Csak földrajzi találatok, üzleti találatok nélkül. |
| `address` | Csak pontos címmel rendelkező földrajzi találatok. |
| `establishment` | Üzleti találatok. |
| `(cities)` | Csak azok a találatok, amelyek `locality` vagy `administrative_area3` típusúak. |
| `(regions)` | Bármely találat a következő típusok közül: `locality`, `sublocality`, `postal_code`, `country`, `administrative_area1`, `administrative_area2`. |

Példák kódból, Google Maps API-val:

```php
// Csak magyarországi javaslatok
'geo' => [
    'api_key' => 'AZ_ON_API_KULCSOD',
    'componentRestrictions' => [
        'country' => 'hu',
    ],
],

// Csak üzleti találatok
'geo' => [
    'api_key' => 'AZ_ON_API_KULCSOD',
    'types' => ['establishment'],
],

// Városok és üzleti találatok
'geo' => [
    'api_key' => 'AZ_ON_API_KULCSOD',
    'types' => ['(cities)', 'establishment'],
],
```
