GET occupants/addresses.{outputFormat}

gov.bc.ca:geocoder

Summary: Geocode an address and identify site occupants
Operation ID:
Auth: unknown
Description

Represents the set of occupants whose addresses best match a given query address. Every occupant has an associated site which has a standardized address and a coordinate location on the Earth.

Parameters (33)

addressString (string, query, optional)

Occupant name OR Occupant name ** address

autoComplete (boolean, query, optional, default: False)

If true, addressString is expected to contain a partial address that requires completion. Not supported for shp, csv, gml formats.

bbox (string, query, optional)

Example: -126.07929,49.7628,-126.0163,49.7907. A bounding box (xmin,ymin,xmax,ymax) that limits the search area. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#bbox target="_blank">bbox</a>

brief (boolean, query, optional, default: False)

If true, include only basic match and address details in results. Not supported for shp, csv, and gml formats.

centre (string, query, optional)

Example: -124.0165926,49.2296251 . The coordinates of a centre point (x,y) used to define a bounding circle that will limit the search area. This parameter must be specified together with 'maxDistance'. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#centre target='_blank'>centre</a>

civicNumber (string, query, optional)

The official number assigned to a site by an address authority. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#civicNumber target="_blank">civicNumber</a>

civicNumberSuffix (string, query, optional)

A letter or fraction that follows the civic number (e.g., the A in 1039A Bledsoe St). See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#civicNumberSuffix target="_blank">civicNumberSuffix</a>

echo (boolean, query, optional, default: False)

If true, include unmatched address details such as site name in results.

extrapolate (boolean, query, optional)

If true, uses supplied parcelPoint to derive an appropriate accessPoint. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#extrapolate target="_blank">extrapolate</a>

interpolation (string, query, optional, default: adaptive)

accessPoint interpolation method. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#interpolation target="_blank">interpolation</a>

Constraints: {'enum': ['adaptive', 'linear', 'none']}

localities (string, query, optional)

A comma separated list of locality names that matched addresses must belong to. For example, setting localities to Nanaimo only returns addresses in Nanaimo

localityName (string, query, optional)

The name of the locality assigned to a given site by an address authority. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#streetDirection target="_blank">streetDirection</a>

locationDescriptor (string, query, optional, default: any)

Describes the nature of the address location. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#locationDescriptor target="_blank">locationDescriptor</a>

Constraints: {'enum': ['any', 'accessPoint', 'frontDoorPoint', 'parcelPoint', 'rooftopPoint', 'routingPoint']}

matchPrecision (string, query, optional, default: OCCUPANT)

Example: street,locality. A comma separated list of individual match precision levels to include in results. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#matchPrecision target="_blank">matchPrecision</a>

matchPrecisionNot (string, query, optional)

Example: street,locality. A comma separated list of individual match precision levels to exclude from results. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#matchPrecisionNot target="_blank">matchPrecisionNot</a>

maxDistance (number, query, optional)

The maximum distance (in metres) to search from the given point. If not specified, the search distance is unlimited.

maxResults (integer, query, optional, default: 1)

The maximum number of search results to return.

minScore (integer, query, optional, default: 1)

The minimum score required for a match to be returned. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#minScore target="_blank">minScore</a>

notLocalities (string, query, optional)

A comma-separated list of localities to exclude from the search.

outputFormat (string, path, required, default: json)

Results format. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#outputFormat target="_blank">outputFormat</a>. Note: GeoJSON and KML formats only support EPSG:4326 (outputSRS=4326)

Constraints: {'enum': ['json', 'geojson', 'xhtml', 'kml', 'gml', 'csv', 'shpz']}

outputSRS (integer, query, optional, default: 4326)

The EPSG code of the spatial reference system (SRS) to use for output geometries. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#outputSRS target="_blank">outputSRS</a>

Constraints: {'enum': [4326, 4269, 3005, 26907, 26908, 26909, 26910, 26911]}

parcelPoint (string, query, optional)

The coordinates of a point (x,y) known to be inside the parcel containing a given address. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#parcelPoint target="_blank">parcelPoint</a>

provinceCode (string, query, optional, default: BC)

The ISO 3166-2 Sub-Country Code. The code for British Columbia is BC.

setBack (integer, query, optional, default: 0)

The distance to move the accessPoint away from the curb and towards the inside of the parcel (in metres). Ignored if locationDescriptor not set to accessPoint.

siteName (string, query, optional)

A string containing the name of the building, facility, or institution (e.g., Duck Building, Casa Del Mar, Crystal Garden, Bluebird House).See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#siteName target="_blank">siteName</a>

streetDirection (string, query, optional)

The abbreviated compass direction as defined by Canada Post and B.C. civic addressing authorities. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#streetDirection target="_blank">streetDirection</a>

Constraints: {'enum': ['N', 'S', 'E', 'W', 'O', 'NE', False, 'NW', 'SE', 'SO', 'SW']}

streetName (string, query, optional)

The official name of the street as assigned by an address authority (e.g., the Douglas in 1175 Douglas Street). See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#streetName target="_blank">streetName</a>

streetQualifier (string, query, optional)

The qualifier of a street name (e.g., the Bridge in Johnson St Bridge)

streetType (string, query, optional)

The type of street as assigned by a municipality (e.g., the ST in 1175 DOUGLAS St). See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#streetType target="_blank">streetType</a>

tags (string, query, optional)

Example: schools;courts;employment<br>A list of tags separated by semicolons.

unitDesignator (string, query, optional)

The type of unit within a house or building. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#unitDesignator target="_blank">unitDesignator</a>

Constraints: {'enum': ['APT', 'BLDG', 'BSMT', 'FLR', 'LOBBY', 'LWR', 'PAD', 'PH', 'REAR', 'RM', 'SIDE', 'SITE', 'SUITE', 'TH', 'UNIT', 'UPPR']}

unitNumber (string, query, optional)

The number of the unit, suite, or apartment within a house or building.

unitNumberSuffix (string, query, optional)

A letter that follows the unit number as in Unit 1A or Suite 302B.

No probe data for this endpoint yet.