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:
- a geolokációs szolgáltatás (API) elérését,
- a mezőcsoport beállításait,
- a címmezőt, amely a javaslatokat kéri,
- 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.
A szolgáltatás elérése
Szekció neve “A szolgáltatás elérése”Google Maps
Szekció neve “Google Maps”- A Google Cloud Platform konzoljában hozz létre egy projektet.
- Engedélyezd a projektben ezeket az API-kat: Google Maps API, Geocoding API, Places API.
- 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
Szekció neve “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
Szekció neve “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
Szekció neve “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:
'geo' => true,Google Maps
Szekció neve “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:
'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
Szekció neve “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:
// 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: