Get Brazilian municipalities latitude

brazil_municipality_latitude() returns the latitude of Brazilian municipalities.

Note: This function requires an internet connection to work and the geobr or geocodebr package to be installed, depending on the chosen method for retrieving coordinates.

Usage

brazil_municipality_latitude(
  municipality_code,
  year = as.numeric(substr(Sys.Date(), 1, 4)),
  coords_method = "geobr",
  names = TRUE,
  ...
)

Arguments

municipality_code

An integerish vector with the IBGE codes of Brazilian municipalities. Use brazil_municipality_code() to obtain codes from municipality names and states.

year

(optional) An integerish number indicating the year of the data regarding the municipalities (default: Sys.Date() |> substr(1, 4) |> as.numeric()).

coords_method

(optional) A character string indicating the method to retrieve the latitude and longitude coordinates of the municipalities (default: "geobr"). Options are:

• "geobr": Uses read_municipal_seat() from the geobr package to retrieve the coordinates.

• "geocodebr": Uses the geocode() from the geocodebr package to retrieve the coordinates.

names

(optional) A logical flag indicating whether to return the names of the municipalities as names of the vector (default: TRUE).

...

(optional) Additional arguments passed to brazil_municipality().

Value

A numeric vector with the latitude of the Brazilian municipalities.

Details

Data from this function is based on data from the Brazilian Institute of Geography and Statistics (IBGE) via the geobr R package.

The geobr package is produced by Brazil's Institute for Applied Economic Research (IPEA) and access the Brazilian Institute of Geography and Statistics (IBGE) data. You can see a list of all geobr datasets by running geobr::list_geobr().

See also

Other Brazil functions: brazil_fu(), brazil_municipality(), brazil_municipality_code(), brazil_municipality_coords(), brazil_municipality_longitude(), brazil_region(), brazil_region_code(), brazil_render_address(), brazil_state(), brazil_state_by_utc(), brazil_state_capital(), brazil_state_code(), brazil_state_latitude(), brazil_state_longitude()

Examples

library(curl)

# \dontrun{
  if (has_internet()) {
    brazil_municipality_latitude(3550308)
  }
#> ! The closest map year to 2026 is 2024. Using year 2024 instead.
#> São Paulo-SP 
#>  -23.5673865 
# }

# \dontrun{
  if (has_internet()) {
    brazil_municipality_latitude(c(3550308, 3500204))
  }
#> ! The closest map year to 2026 is 2024. Using year 2024 instead.
#> São Paulo-SP    Adolfo-SP 
#> -23.56738650 -21.23272978 
# }

# \dontrun{
  if (has_internet()) {
    brazil_municipality_latitude(c(3550308, 1000, 3500204))
  }
#> ! The closest map year to 2026 is 2024. Using year 2024 instead.
#> São Paulo-SP         <NA>    Adolfo-SP 
#> -23.56738650           NA -21.23272978 
# }

# \dontrun{
  if (has_internet()) {
    brazil_municipality_latitude(c(3550308, NA, 3500204))
  }
#> ! The closest map year to 2026 is 2024. Using year 2024 instead.
#> São Paulo-SP         <NA>    Adolfo-SP 
#> -23.56738650           NA -21.23272978 
# }