GET /addresses.{outputFormat}
Operation ID: —
Auth: unknown
Description
Represents the set of geocoded and standardized sites and intersections whose address best matches a given query address.
Parameters (32)
(string, query, optional)
Civic or intersection address as a single string. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#addressString target="_blank">addressString</a>
(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.
(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>
(boolean, query, optional, default: False)
If true, include only basic match and address details in results. Not supported for shp, csv, and gml formats.
(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>
(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>
(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>
(boolean, query, optional, default: True)
If true, include unmatched address details such as site name in results.
(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>
(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']}
(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
(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#localityName target="_blank">localityName</a>
(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']}
(string, query, optional)
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>
(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>
(number, query, optional)
The maximum distance (in metres) to search from the given point. If not specified, the search distance is unlimited.
(integer, query, optional, default: 1)
The maximum number of search results to return.
(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>
(string, query, optional)
A comma-separated list of localities to exclude from the search.
(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']}
(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]}
(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>
(string, query, optional, default: BC)
The ISO 3166-2 Sub-Country Code. The code for British Columbia is BC.
(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.
(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>
(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']}
(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>
(string, query, optional)
Example: the Bridge in Johnson St Bridge. The qualifier of a street name. See <a href=https://github.com/bcgov/ols-geocoder/blob/gh-pages/glossary.md#streetQualifier target="_blank">streetQualifier</a>
(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>
(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']}
(string, query, optional)
The number of the unit, suite, or apartment within a house or building.
(string, query, optional)
A letter that follows the unit number as in Unit 1A or Suite 302B.
No probe data for this endpoint yet.