Skip to contents

Geocode reverso de coordenadas espaciais no Brasil

Source: R/geocode_reverso.R
geocode_reverso.Rd

Geocode reverso de coordenadas geográficas para endereços. A função recebe um sf data frame com pontos e retorna o endereço mais próximo dando uma distância máxima de busca.

Usage

geocode_reverso(
  pontos,
  dist_max = 1000,
  verboso = TRUE,
  cache = TRUE,
  n_cores = 1
)

Arguments

pontos

Uma tabela de dados com classe espacial sf data frame no sistema de coordenadas geográficas SIRGAS 2000, EPSG 4674.

dist_max

Integer. Distancia máxima aceitável (em metros) entre os pontos de input e o endereço Por padrão, a distância é de 1000 metros.

verboso

Um valor lógico. Indica se barras de progresso e mensagens devem ser exibidas durante o download dos dados do CNEFE e a geocodificação dos endereços. O padrão é TRUE.

cache

Um valor lógico. Indica se os dados do CNEFE devem ser salvos ou lidos do cache, reduzindo o tempo de processamento em chamadas futuras. O padrão é TRUE. Quando FALSE, os dados do CNEFE são baixados para um diretório temporário.

n_cores

Um número. O número de núcleos de CPU a serem utilizados no processamento dos dados. O padrão é 1.

Value

Retorna o sf data.frame de input adicionado das colunas do endereço encontrado. O output inclui uma coluna "distancia_metros" que indica a distância entre o ponto de input e o endereço mais próximo encontrado.

Examples

library(geocodebr)
library(sf)
#> Linking to GEOS 3.10.2, GDAL 3.4.1, PROJ 8.2.1; sf_use_s2() is TRUE

# ler amostra de dados
pontos <- readRDS(
    system.file("extdata/pontos.rds", package = "geocodebr")
    )

ponto <- pontos[1,]

# geocode reverso
df_enderecos <- geocodebr::geocode_reverso(
  pontos = ponto,
  dist_max = 800,
  verboso = TRUE,
  n_cores = 1
  )
#> ℹ Utilizando dados do CNEFE armazenados localmente

head(df_enderecos)
#> Simple feature collection with 1 feature and 11 fields
#> Geometry type: POINT
#> Dimension:     XY
#> Bounding box:  xmin: -40.7334 ymin: -19.29416 xmax: -40.7334 ymax: -19.29416
#> Geodetic CRS:  SIRGAS 2000
#>   id                                       endereco_completo estado municipio
#> 1  1 CORREGO BOA VISTA, 32 - LAJINHA, PANCAS - ES, 29750-000     ES    PANCAS
#>          logradouro numero       cep localidade lat_cnefe lon_cnefe
#> 1 CORREGO BOA VISTA     32 29750-000    LAJINHA -19.29112 -40.73766
#>   distancia_metros                   geometry
#> 1         560.6426 POINT (-40.7334 -19.29416)