Job Map

You can show your jobs on a map, so visitors can see where jobs are and search near a place. Add the Job Map block (wcb/job-map) to a page, or use the shortcode [wcbp_job_map].

The page

The setup wizard creates a Job Map page at /job-map/ that holds the block. It is listed under Career Board → Settings → Pages as Job Map Page. If it is missing, click Create Missing Pages on that tab. You can also add the block to any page.

What visitors can do

• Click a pin to see the job title, company and location, with a View Job link.
• Type a city or postcode, pick a radius and click Search. The map moves to that place and shows jobs within the radius, up to 100. The radius choices are 5, 10, 25, 50 and 100 km. The default is 25 km.
• Click the Use my location button to search around their position.
• If the place cannot be found, a line under the toolbar says “Location search failed. Please try again.”

The map holds the newest 500 published jobs that have coordinates. When more jobs have a location, a line under the map reads “Showing the newest 500 of N jobs. Use the job search to find the rest.” A job with no coordinates is left off.

If the map has no pins when the page loads, the block shows “No jobs with locations yet” and hides the search bar.

If a Job Listings block is on the same page, the map narrows its pins to the jobs in the current list.

Block setting

Setting	Default	What it does
Height	480	Height of the map in pixels.

Radius search in the REST API

You can search by distance on the jobs route: GET /wcb/v1/jobs?lat=48.85&lng=2.35&radius=25. radius is in kilometres, from 1 to 500, and defaults to 25. Only jobs with saved coordinates match.

The search area is a square around the point, so its corners reach a little past the radius (about 1.4 times).

Choose a map provider

Go to Career Board → Settings → Integrations → Map settings, choose a Map Provider and click Save Integrations.

Provider	Key needed	Notes
Leaflet / OpenStreetMap	No	The default. Turns places into coordinates with Nominatim.
Google Maps	Yes	Needs a Google Maps API key with the Geocoding API on.
Mapbox	Yes	Needs a Mapbox access token.

The provider only changes how places become coordinates. The map itself is always drawn with Leaflet and OpenStreetMap tiles. Once a key is saved, its field shows “Saved - leave blank to keep”.

How jobs get coordinates

Coordinates are never looked up while you save. When a job or resume is saved, created or imported with a location, a background task looks up its coordinates shortly after.

• The location comes from the job’s Location terms. Terms such as “Remote”, “Anywhere”, “Worldwide”, “Hybrid”, “Other”, “Work from home” and “WFH” are ignored, so a job with only those has no pin. The wcbp_non_geographic_location_terms filter changes this list.
• A job is looked up again only when its location changes.
• After an upgrade from a version before 1.7.1, existing jobs and resumes without coordinates are looked up in the background, 25 at a time with about a second between lookups.

Place search limits

The place search box calls GET /wcb/v1/geocode?address=.... The address must be 2 to 200 characters. Results are cached for 24 hours, and a failed lookup is cached for an hour. Each IP address can make 30 new lookups per hour; searches answered from the cache do not count. The count resets after an hour with no new lookup.

Filters

Filter	Default	What it does
wcbp_geocode_backfill_batch	25	Rows looked up in each background run (1 to 100).
wcbp_geocode_throttle_us	1100000	Pause between background lookups, in microseconds.
wcbp_geocode_rate_limit	30	New place searches per IP address per hour. 0 turns the limit off.

For the resume version of this map, see Find Candidates and the resume map.