Skip to content
WP Job Portal DocsWP Job Portal DocsWP Job Portal Docs

Maps

Requires Pro

With Pro, jobs and resumes can carry a map position, and job and resume pages show a map. You choose the map provider: Google Maps, which needs an API key, or OpenStreetMap, which does not.

Set up maps

Section titled “Set up maps”
  1. Open WP Job Portal → Settings.
  2. Open the Integrations tab.
  3. Find Mapping & Geo Location.
  4. Set the options below.
  5. Save the settings.

The Mapping & Geo Location settings on the Integrations tab: Mapping Service, Google Map API Key, Map Height px, Default Longitude, Default Latitude and Default Map Radius Type

Option What it does
Mapping Service Google Map or Open Street Map.
Google Map API Key Your Google Maps API key. Needed only for Google Map.
Map Height px Height of the maps the plugin draws, in pixels.
Default Longitude Where a map is centred when nothing else sets its position.
Default Latitude As above.
Default Map Radius Type Meters, Kilometers, Miles or Nautical Miles. Nothing on the site uses this setting yet.

The same section also holds Max Records for City Field and Max Records for Tag Field, the number of suggestions the city and tag boxes offer as you type.

Google Maps needs your own key

Section titled “Google Maps needs your own key”

Mapping Service is Google Map on a new site, and there is no key. Until you add one, or switch to Open Street Map:

  • job and resume maps stay hidden;
  • the latitude and longitude that employers and job seekers enter are still saved;
  • a new city typed while editing an existing company or job is not added (in 2.9.0). Adding a new company or job is not affected. Add a Google key or choose Open Street Map to avoid this;
  • the plugin’s admin screens show “Add your Google Maps key in Settings to show maps.” with an Open Settings button. Dismiss hides it for you.

Before 2.8.0 every site shared one built-in Google key, whose daily limit kept running out for everyone at once. 2.8.0 removed it. A key you entered yourself is kept.

Create the Google key in your Google Cloud account with the Maps JavaScript API enabled. Google’s own setup steps change from time to time, so follow their current guide.

Where maps appear

Section titled “Where maps appear”
Place What you see
Job form A map picker with Longitude and Latitude boxes. Employers click the map or type the position.
Job detail page A map of the job’s position, when the job has one.
Resume form A Map link in the address section that opens a picker, with Latitude and Longitude boxes.
Resume detail page A map of the address position.
Jobs On Map Widget and [wpjobportal_jobsonmap] The newest jobs as pins. Only jobs with a position appear.

The job form’s map is the Map field. You can unpublish it or change its title in the field manager.

Searching by distance

Section titled “Searching by distance”

The job search page has no map, position or distance fields, so job seekers can’t search by distance. They search by City instead.

The company form has no map. When an employer types a new city there, Google is used to look up its position, if you use Google Maps with a key.

Section titled “Related”