Module · Geo

Geo settings

Where: ExpertPress → Geolocation (Геолокація). The same form is also available as Geo (Гео) in the Modules section of the ExpertPress admin.

Who can change it: administrators and ExpertPress Managers (permission expertpress_operate). No option on this screen is administrator-only. See Roles and access.

What this screen is for

Optional map and nearby search for offline or hybrid services. Leave disabled on online-only marketplaces. The screen switches the module on, chooses where the map comes from, and sets the privacy and radius rules for the public map and nearby search. Everything is saved with Save geolocation settings (Зберегти налаштування геолокації); the result is "Geolocation settings saved." or "Geolocation settings could not be saved. Please try again."

Every save refreshes the service catalog cache. Changing Public marker offset (meters) also marks the public map data as out of date; nearby search then answers "unavailable" until the public data is prepared again (see Getting it running). Other changes keep the current state.

Numbers outside the allowed range are not refused; they are moved to the nearest allowed value when you save.


Enable geolocation

  • Where: ExpertPress → Geolocation (checkbox Register map blocks, nearby filter, and REST geo fields)
  • What it does: Turns the module on. When on, the Locations tab appears in the specialist cabinet, the ExpertPress Map and ExpertPress Nearby Filter blocks and their shortcodes work, and catalog REST responses include public geo fields. When off, all of that disappears; saved locations are kept. Old links that still carry nearby parameters are not guaranteed to show a filtered list.
  • Default: off.
  • Values / limits: on or off.
  • When to change it: turn it on when you start offering in-person or hybrid sessions; turn it off on a purely online marketplace so specialists are not asked for addresses.
  • Related: Overview

Map provider

  • Where: same screen
  • What it does: Chooses which map library draws the maps on the public pages and the location picker in the cabinet.
    • MapLibre (configurable tiles; default) — the bundled MapLibre library with tiles from MapLibre tile URL template.
    • Google Maps — Google's map, needs Google Maps browser API key and Allow remote Google / Mapbox SDKs.
    • Mapbox — Mapbox GL, needs Mapbox public access token and Allow remote Google / Mapbox SDKs.
    • None (manual coordinates only) — described as manual coordinates only, but in the current code it behaves the same as MapLibre: the bundled map still loads and uses the tile URL if one is set.
  • Default: MapLibre.
  • Values / limits: the four options above. If Google Maps or Mapbox is chosen but its key is empty or remote SDKs are not allowed, no map script loads: the map areas stay empty, and specialists can still type latitude and longitude by hand.
  • When to change it: pick Google Maps if your team already has a Google Cloud billing account and wants familiar street maps; pick Mapbox for its styled maps; stay with MapLibre to avoid sending visitors to Google or Mapbox and to choose your own tile host.
  • Related: Privacy and data

Allow remote Google / Mapbox SDKs

  • Where: same screen
  • What it does: Allows the visitor's browser to load Google Maps or Mapbox GL from their official hosts when one of those providers is selected (your own API key is required). MapLibre is bundled with the module and does not depend on this option.
  • Default: on.
  • Values / limits: on or off.
  • When to change it: turn it off if your privacy policy does not allow third-party map scripts; with Google Maps or Mapbox selected, maps then stop loading, so switch the provider to MapLibre at the same time.
  • Related: Map provider

MapLibre tile URL template

  • Where: same screen
  • What it does: The address of the raster tile server MapLibre uses, in the usual {z}/{x}/{y} template form (for example https://tiles.example.com/{z}/{x}/{y}.png). Tiles are 256-pixel raster images. Do not point at tile.openstreetmap.org for production load without complying with the OpenStreetMap Foundation tile policy.
  • Default: empty. With no tile URL, MapLibre draws a plain grey background; markers and pin picking still work.
  • Values / limits: a URL. Needs an external account unless you run your own tile server; the tile host's terms and prices apply.
  • When to change it: set it as soon as you choose MapLibre; switch it when you move to a different tile provider.
  • Related: Tile attribution

Tile attribution

  • Where: same screen
  • What it does: The credit line shown in the corner of MapLibre maps, for example "© OpenStreetMap contributors" or your tile provider's required text.
  • Default: empty.
  • Values / limits: plain text, no HTML.
  • When to change it: most tile providers require a specific attribution; copy it from their terms when you set the tile URL.
  • Related: MapLibre tile URL template

Default privacy

  • Where: same screen
  • What it does: The privacy level a specialist's new location form starts with. The specialist can change it per service.
    • Public area (city/district + offset marker) — the marker is moved away from the real point; city and district are shown.
    • Public exact (opt-in precise marker) — the marker is at the exact point.
    • Exact private (owner/staff only) — not on the map and not found by nearby search.
  • Default: Public area.
  • Values / limits: the three levels above. Changing the default does not change locations that are already saved.
  • When to change it: choose Public exact if most specialists work from public offices or studios; choose Exact private if you only want to collect addresses for your team, not to show them.
  • Related: Public marker offset (meters); What changes for each side

Default radius (km)

  • Where: same screen
  • What it does: The search radius used by the nearby filter when the visitor does not enter one, and the radius used when a request asks for less than 1 km.
  • Default: 10 km.
  • Values / limits: 1–500 km, and never more than Maximum radius (km) (it is lowered to the maximum on save if needed).
  • When to change it: 3–5 km for a single dense city; 25–50 km for a regional marketplace where clients drive to sessions.
  • Related: Maximum radius (km); Radius choice

Maximum radius (km)

  • Where: same screen
  • What it does: The largest radius any nearby search may use. A larger radius in a request is cut down to this value.
  • Default: 100 km.
  • Values / limits: 1–500 km.
  • When to change it: lower it to keep nearby results meaningful in a city marketplace; raise it for a country-wide directory of in-person practitioners.
  • Related: Default radius (km)

Radius choice

  • Where: same screen (checkbox Allow visitors to choose the search radius (Дозволити відвідувачам обирати радіус пошуку))
  • What it does: When on, the nearby filter shows a Radius (km) field (from 1 up to the maximum). When off, the nearby filter uses the default radius only (no radius field).
  • Default: on.
  • Values / limits: on or off.
  • When to change it: turn it off for a simpler filter on a city site where one radius suits everyone.
  • Related: Default radius (km)

Public marker offset (meters)

  • Where: same screen
  • What it does: How far a Public area marker may be moved from the real point. Each service gets its own fixed direction and distance, between 35% and 100% of this value, and never less than 50 m even if you enter 0. Public exact and Exact private points are not affected.
  • Default: 100 m.
  • Values / limits: 0–2000 m. After a change, the public map data must be prepared again before nearby search works (see Getting it running).
  • When to change it: raise it to 300–500 m if specialists receive clients at home and want their building to stay hidden; keep it small in areas where a few hundred metres puts a marker in another district.
  • Related: Default privacy

Google Maps browser API key

  • Where: same screen
  • What it does: The key used to load Google Maps in visitors' browsers when Map provider is Google Maps.
  • Default: empty.
  • Values / limits: text. Needs a Google Cloud account with the Maps JavaScript API enabled. The key is visible in the page source of every page with a map, as with any browser key; restrict it to your site's domain in the Google Cloud console.
  • When to change it: when you switch to Google Maps, or rotate the key.
  • Related: Map provider; Allow remote Google / Mapbox SDKs

Mapbox public access token

  • Where: same screen
  • What it does: The public token used to load Mapbox maps in visitors' browsers when Map provider is Mapbox.
  • Default: empty.
  • Values / limits: text. Needs a Mapbox account. Use a public token (it is visible in the page source) and restrict it to your site's URL in your Mapbox account.
  • When to change it: when you switch to Mapbox, or rotate the token.
  • Related: Map provider; Allow remote Google / Mapbox SDKs

Specialist cabinet: Locations tab

This tab is not an admin setting, but it is where the data comes from. It appears in the specialist cabinet only while geolocation is enabled. For each of the specialist's services it shows Latitude, Longitude, City label, Area / district, Full address (private), Privacy, a small map for picking the point, and Save location. A specialist can edit only their own services; an administrator can save a location for any service. Details are in What changes for each side.