BC Geographical Names Web Service - REST API
This REST API provides searchable access to information about geographical names in the province of British Columbia, including name status and details about…
Government & public#openapi#open-data
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
This REST API provides searchable access to information about geographical names in the province of British Columbia, including name status and details about the corresponding geographic feature.
Please note that you may experience issues when submitting requests to the delivery or test environment if using this OpenAPI specification in other API console viewers.
Endpoints 14
search
- GETSearch for names with metadata changes in a given period
/names/changes?outputFormat=json&fromDate=2017-01-01&toDate=2017-06-30&featureClass=*&featureCategory=*&featureType=*&sortBy=name&outputSRS=4326&embed=0&outputStyle=summary&itemsPerPage=20&startIndex=1Search for information about geographical names which have changed most recently within a specified time window. Changes may include status cupdates and… - GETSearch for names affected by recent naming decision
/names/decisions/recent?outputFormat=json&days=30&featureClass=*&featureCategory=*&featureType=*&sortBy=name&outputSRS=4326&embed=0&outputStyle=summary&itemsPerPage=20&startIndex=1Search for information about geographical names affected by naming 'decisions' made by the BC Geographical Names Office (naming authority) within the last X… - GETSearch for names affected by naming decisions in a given year
/names/decisions/year?outputFormat=json&year=2007&featureClass=*&featureCategory=*&featureType=*&sortBy=name&outputSRS=4326&embed=0&outputStyle=summary&itemsPerPage=20&startIndex=1Search for information about geographical names affected by naming 'decisions' made by the BC Geographical Names Office (naming authority) in a given year. - GETSearch in a geographic area
/names/inside?outputFormat=json&bbox=-119,49,-118,50&featureClass=*&featureCategory=*&featureType=*&sortBy=name&outputSRS=4326&embed=0&outputStyle=summary&itemsPerPage=20&startIndex=1Search for information about geographical names that correspond to features within a geographic bounding box. Various options and filter parameters are… - GETSearch near to a geographic point
/names/near?outputFormat=-119,49,-118,50&featurePoint=-120,51&distance=string&featureClass=*&featureCategory=*&featureType=*&sortBy=name&outputSRS=4326&embed=0&outputStyle=summary&itemsPerPage=20&startIndex=1Search for information about geographical names that correspond to features within a geographic area defined by a centre point and a radius. Various options… - GETSearch by name, limit to unofficial names only
/names/notOfficial/search?outputFormat=json&name=Victoria&exactSpelling=0&featureClass=*&featureCategory=*&featureType=*&sortBy=relevance&outputSRS=4326&embed=0&outputStyle=summary&itemsPerPage=20&startIndex=1Search for information about unofficial geographical names by the text of the name itself. Various options and filter parameters are available to refine the… - GETSearch by name, limit to official names only
/names/official/search?outputFormat=json&name=Victoria&exactSpelling=0&featureClass=*&featureCategory=*&featureType=*&sortBy=relevance&outputSRS=4326&embed=0&outputStyle=summary&itemsPerPage=20&startIndex=1Search for information about official geographical names by the text of the name itself. Various options and filter parameters are available to refine the… - GETSearch by name
/names/search?outputFormat=json&name=Victoria&exactSpelling=0&featureClass=*&featureCategory=*&featureType=*&sortBy=relevance&outputSRS=4326&embed=0&outputStyle=summary&itemsPerPage=20&startIndex=1Search for information about geographical names by the text of the name itself. The response will include both official and unofficial names. Various options…
name
- GETGet a name by its nameId
/names/:nameId.:outputFormatGet information about the geographical name with the specified nameId.
feature
- GETGet a feature by its featureId
/features/:featureIdGet information about the geographical feature with the specified featureId.
feature taxonomy
- GETGet all feature categories
/featureCategories?outputFormat=jsonGets a list of all feature categories used by the BC Geographical Names Information System (BCGNIS). Note: there are three levels of classification in the… - GETGet all feature classes
/featureClasses?outputFormat=jsonGets a list of all feature classes used by the BC Geographical Names Information System (BCGNIS). Note: there are three levels of classification in the BCGNIS… - GETGet all feature types
/featureTypes?outputFormat=jsonGets a list of all feature types used by the BC Geographical Names Information System (BCGNIS). Note: there are three levels of classification in the BCGNIS…
name authority
- GETGet all name authorities
/nameAuthorities?outputFormat=jsonGets a list of all name authorities responsible for naming decisions of the geographical names in the BC Geographical Names Information System (BCGNIS)
API details
- Base URL
https://apps.gov.bc.ca/pub/bcgnwshttps://test.apps.gov.bc.ca/pub/bcgnwshttps://delivery.apps.gov.bc.ca/pub/bcgnws- Authentication
- None declared in the description
- Operations
- 14 operations on 14 pathsGET 14
- Main resources
- name 9search 8feature taxonomy 3feature 1name authority 1
- Description format
- OpenAPI 3.0.0, API version
3.x.x - Links
- OpenAPI document · Support
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the BC Geographical Names Web Service - REST API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the BC Geographical Names Web Service - REST API collection, without the publisher's secrets.
- Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
- Send a requestPick an endpoint, for example “Search for names with metadata changes in a given period” (GET /names/changes?outputFormat=json&fromDate=2017-01-01&toDate=2017-06-30&featureClass=*&featureCategory=*&featureType=*&sortBy=name&outputSRS=4326&embed=0&outputStyle=summary&itemsPerPage=20&startIndex=1), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the BC Geographical Names Web Service - REST API?
This REST API provides searchable access to information about geographical names in the province of British Columbia, including name status and details about… It is listed under Government & public and has 14 endpoints.
Who publishes the BC Geographical Names Web Service - REST API?
It is listed from Bc's public API description (an OpenAPI document), not published by Bc on Swastik Codes. Anyone who controls gov.bc.ca can claim the profile by adding a DNS TXT record.
What is the base URL of the BC Geographical Names Web Service - REST API?
Its description lists 3 base URLs: https://apps.gov.bc.ca/pub/bcgnws, https://test.apps.gov.bc.ca/pub/bcgnws, https://delivery.apps.gov.bc.ca/pub/bcgnws. The first is the usual one; the others are typically sandbox or regional servers.
How do I authenticate with the BC Geographical Names Web Service - REST API?
Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.
How many endpoints does the BC Geographical Names Web Service - REST API have?
14 operations on 14 paths (14 GET). The largest groups are name, search, feature taxonomy, feature.
Is forking the BC Geographical Names Web Service - REST API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.