aq_cities: Provides a simple listing of cities within the platform.

In masalmon/ropenaq: Accesses Air Quality Data from the Open Data Platform OpenAQ

Provides a simple listing of cities within the platform.

Description

Provides a simple listing of cities within the platform.

Usage

aq_cities(country = NULL, limit = 10000, page = NULL)

Arguments

country	Limit results by a certain country – a two-letters code see countries() for finding code based on name.
limit	Change the number of results returned, max is 10000 by page. If no page value, then all results or limit * 100 (maximal number of pages) is returned.
page	The page of the results to query (max 100).

Details

For queries involving a city argument, the URL-encoded name of the city (as in cityURL), not its name, should be used.

Value

A results data.frame (dplyr "tbl_df") with 5 columns:

• city name ("city"), country code ("country"),

• number of measures in total for the city ("count"),

• number of locations ("locations"),

• and also an URL encoded string for the city ("cityURL") which can be useful for queries involving a city argument.

and 2 attributes, a meta data.frame (dplyr "tbl_df") with 1 line and 5 columns:

• the API name ("name"),

• the license of the data ("license"),

• the website url ("website"),

• the queried page ("page"),

• the limit on the number of results ("limit"),

• the number of results found on the platform for the query ("found")

and a timestamp data.frame (dplyr "tbl_df") with the query time and the last time at which the data was modified on the platform.

Examples

## Not run: 
cities <- aq_cities(country = "BA")
cities

## End(Not run)

masalmon/ropenaq documentation built on May 17, 2022, 4:43 a.m.