Download estimates of access to employment, health, education and social assistance services by transport mode and time of the day for the cities included in the AOP project. See the documentation 'Details' for the data dictionary. The data set reports information for each heaxgon in a H3 spatial grid at resolution 9, with a side of 174 meters and an area of 0.10 km2. More information about H3 at

  city = NULL,
  mode = "walk",
  peak = TRUE,
  year = 2019,
  geometry = FALSE,
  showProgress = TRUE



Character. A city name or three-letter abbreviation. If city="all", the function returns data for all cities.


Character. A transport mode. Modes available include 'public_transport', 'bicycle', or 'walk' (the default).


Logical. If TRUE (the default), returns accessibility estimates during peak time, between 6am and 8am. If FALSE, returns accessibility during off-peak, between 2pm and 4am. This argument only takes effect when mode is either car or public_transport.


Numeric. A year number in YYYY format. Defaults to 2019.


Logical. If FALSE (the default), returns a regular data.table of aop data. If TRUE, returns an sf data.frame with simple feature geometry of spatial hexagonal grid H3. See details in read_grid.


Logical. Defaults to TRUE display progress bar.


A data.frame object

Data dictionary:

temporalyearYear of reference
transportmodeTransport modewalk; bicycle; public_transport; car
transportpeakPeak and off-peak1 (peak); 0 (off-peak)

The name of the columns with accessibility estimates are the junction of three components: 1) Type of accessibility indicator 2) Type of opportunity / population 3) Time threshold

1) Type of accessibility indicator

CMACumulative opportunity measure (active)
CMPCumulative opportunity measure (passive)
TMITravel time to closest opportunityValue = Inf when travel time is longer than 2h (public transport or car) or 1,5h (walking or bicycle)

2) Type of opportunity / population

Type of opportunityDescriptionObservation: available in combination with
TTAll jobsCMA indicator
TBJobs with primary educationCMA indicator
TMJobs with secondary educationCMA indicator
TAJobs with tertiary educationCMA indicator
STAll healthcare facilitiesCMA and TMI indicators
SBHealthcare facilities - Low complexityCMA and TMI indicators
SMHealthcare facilities - Medium complexityCMA and TMI indicators
SAHealthcare facilities - High complexityCMA and TMI indicators
ETAll public schoolsCMA and TMI indicators
EIPublic schools - early childhoodCMA and TMI indicators
EFPublic schools - elementary schoolsCMA and TMI indicators
EMPublic schools - high schoolsCMA and TMI indicators
MTAll school enrollmentsCMA and TMI indicators
MISchool enrollments - early childhoodCMA and TMI indicators
MFSchool enrollments - elementary schoolsCMA and TMI indicators
MMSchool enrollments - high schoolsCMA and TMI indicators
CTAll Social Assistance Reference Centers (CRAS)CMA and TMI indicators
PeopleDescriptionObservation: available in combination with
PTAll populationCMP indicator
PHMenCMP indicator
PMWomenCMP indicator
PBWhite populationCMP indicator
PAAsian-descendent populationCMP indicator
PIIndigenous populationCMP indicator
PNBack populationCMP indicator
P0005IPopulation between 0 and 5 years oldCMP indicator
P0614IPopulation between 6 and 14 years oldCMP indicator
P1518IPopulation between 15 and 18 years oldCMP indicator
P1924IPopulation between 19 and 24 years oldCMP indicator
P2539IPopulation between 25 and 39 years oldCMP indicator
P4069IPopulation between 40 and 69 years oldCMP indicator
P70IPopulation with 70 years old or moreCMP indicator

3) Time threshold (only applicable to CMA and CMP estimates)

Time threshold**Description **Observation: only applicable to
15Opportunities accessible within 15 min.Active transport modes
30Opportunities accessible within 30 min.All transport modes
45Opportunities accessible within 45 min.Active transport modes
60Opportunities accessible within 60 min.All transport modes
90Opportunities accessible within 90 min.Public transport and car
120Opportunities accessible within 120 min.Public transport and car

4) Cities available

City nameThree-letter abbreviationTransport modes
Belo HorizontebhoAll
Campo GrandecgrActive
Duque de CaxiasduqActive
Porto AlegrepoaAll
Rio de JaneirorioAll
Sao GoncalosgoActive
Sao LuisslzActive
Sao PaulospoAll


# Read accessibility estimates of a single city
df <- read_access(city = 'Fortaleza', mode = 'public_transport', year = 2019, showProgress = FALSE)
df <- read_access(city = 'Goiania', mode = 'public_transport', year = 2019, showProgress = FALSE)

# Read accessibility estimates for all cities
all <- read_access(city = 'all', mode = 'walk', year = 2019, showProgress = FALSE)