Location Overview

AdeptID supports locations in the United States at the city, county, metropolitan area, state and national levels.

Location Schema

AdeptID’s location schema uses standard US Government taxonomies. We use FIPS (Federal Information Processing Standard) codes as IDs.

Implementation tip: For most job search and analytical use cases, we recommend using a Metropolitan Statistical Area (MSA) as the search region. MSAs are defined by the US government as a city and economically connected surrounding communities. Note that MSAs may cross state boundaries and some rural areas are not part of any MSA.

FIELDTYPESHORT DESCRIPTION
city_namestringName of the city.
county_fipsstringCode of the county containing the specified location.
county_namestringName of the county containing the specified location.
msa_fipsstringCode of the MSA containing the specified location.
msa_namestringOfficial name of the MSA containing the specified location.
msa_common_namestringCommon name of the MSA containing the specified location. This is typically the name of the largest city in the MSA.
state_abbreviationstringTwo letter abbreviations of the state containing the specified location.
state_fipsstring2 digit code of the state containing the specified location.
state_namestringName of the state containing the specified location.
metrostringMetropolitan statistical area (MSA).
geo_coordinatesobjectGeographic coordinates of the metro. See below for schema information.
postal_codestringPostal code for an address.
street_addressarray of stringsIndividual lines of a mailing address.

Geo Coordinates

Locations include geographic coordinates for the center of the associated MSA.

FIELDTYPESHORT DESCRIPTION
latitudefloatLatitude of the MSA.
longitudefloatLongitude of the MSA.

Location Example

{
	"city_name": "Jersey City",
	"county_fips": "34017",
	"county_name": "Hudson",
	"msa_common_name": "New York, NY",
	"msa_fips": "35620",
	"msa_name": "New York-Newark-Jersey City, NY-NJ-PA",
	"state_abbreviation": "NJ",
	"state_fips": "34",
	"state_name": "New Jersey"
}

Location Taxonomy

Use Cases for Location Taxonomy

  • Location Standardization: AdeptID classifies locations, taking in city, state or metropolitan area and returning a full set of locational metadata. This use case is satisfied with Location Search.

  • Analysis of Occupational Data: AdeptID provides occupational metadata such as demographics, supply and demand which vary by location. This use case is satisfied with Occupation Metadata.

  • Filtering of Job and Candidate Results: When searching against a feed of jobs or candidates, users may filter results to only include those in specific locations. (In Development)

Location Taxonomy Overview

The locations in the AdeptID location taxonomy and data model include:

LOCATION TYPEDESCRIPTION
cityIndividual cities and towns. In some cases, APIs recognizes neighborhoods which are not official political designations as cities. Cities do not have IDs according to the FIPS information systems.
countyCounties are composed of a set of one or more cities. Each county has a unique FIPS code.
stateUS States, territories and Washington, DC. Each state has a unique FIPS code.
MSAMetropolitan Statistical Areas are region that consists of a city and surrounding communities linked by social and economic factors. They are defined by US Government and each MSA has a unique FIPS code.

Note that MSAs may cross state boundaries (e.g. the New York MSA includes parts of Connecticut, New Jersey, and Pennsylvania) and some areas (particularly rural ones) may not be a part of any MSA.
countryNations. Currently, AdeptID supports US locations only.