Tovább a tartalomhoz

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 fejezet írja le.

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

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

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

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:

'geo' => true,

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:

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

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:

// 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'],
],

Készült:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások