SEEK’s location hierarchy has been extended with increased granularity in core Asia-Pacific locations. If you have already built a supported implementation option in your software, these changes have been automatically rolled out to your hirers and you can skip to the next section.
Legacy integrations that use static location mappings must move to a supported option as part of this uplift. SEEK can no longer justify the effort of producing mapping files tailored to each partner and the administrative overhead of managing manual updates, particularly as our ontologies have expanded in scope and are now evolving at a quicker pace. For reference, our location hierarchy has been revised six times over the past six months.
- If your software has its own location hierarchy which contains latitudes and longitudes, build nearest locations then provide the first location ID to our posting mutations.SEEK will reliably infer a location based on the closest proximity to the supplied coordinates.
- If your software has its own location hierarchy which lacks latitudes and longitudes, you can provide structured address details to the new
inferLocationquery . This query will attempt to match the details to a location in our hierarchy on a best-effort basis. The ID of the location returned can then be passed to the
positionLocationfield in our posting mutations.If your location hierarchy lacks such structure, you can provide the address as a single formatted line, though unstructured input may produce less consistent results:SEEK will infer a location based on the closest match to the supplied text. You should test and fine tune the data format provided by your software, starting with the following recommended baselines:CountryFieldsExampleAUsuburb, postcode, countryCremorne, 3121, AUAUsuburb, state, postcode, countryCremorne, VIC 3121, AUNZsuburb, region , countryMilford Sound, Southland, NZOthermajor city, province/state, countryGeorge Town, Penang, MYOtherprovince/state, countryPerak, MYThe
inferLocationquery will only return locations suitable for posting a job ad, similar to the
PositionPostingusage type for location suggest, and will return
nullif a valid location cannot be inferred from the provided data.If this occurs, the hirer will be unable to proceed to post their job ad to SEEK, and you should review the quality of the address details that your software sends to the SEEK API.