La fonction codeComToCoord permet de récupérer des coordonnées WGS84 (EPSG 4326) de plusieurs communes à partir des codes communes INSEE.

Les points en sortie correspondent aux chefs-lieux de communes (chx), aux centroïdes ou à des points situés obligatoirement à l'intérieur de la commune, calculés selon l'algorithme spécifique "point_on_surface".

Selon la morphologie du contour de la commune, le centroïde peut être situé en-dehors de ses limites. Pour que le point soit obligatoirement situé dans la commune, il faut alors spécifier type = "pos" (point_on_surface).

Il est possible de choisir une géographie de 2017 à l'année de mise à jour du package. Par exemple, si le package a été mis à jour en géographie 2024, il peut transformer en coordonnées lon/lat des codes communes des COG 2017 à 2024.

Pour information, il est possible de récupérer sous forme de table l'ensemble des codes communes Insee d'un millésime donné avec leurs coordonnées centroïde, pos et chx. Pour ce faire il suffit de taper la commande metric.osrm:::tablePassage20xx

codeComToCoord(codeInsee, geo = "2024", type = "chx")

Arguments

codeInsee

vecteur texte.

geo

texte. Par défaut, l'année courante.

type

texte. Type de point souhaité. A choisir parmi "chx" par défaut (chef-lieu de la commune), "centroide" (barycentre) ou "pos" (point sur la surface).

Value

Un data.frame de trois colonnes "code", "lon" et "lat".

Examples

# Renvoie les coordonnees des chefs-lieux des communes de Montrouge (92049)
# et de Malakoff (92046) en geographie 2024.
codeComToCoord(codeInsee = c("92049","92046"),
               geo = "2024",
               type = "chx")
#>    code     lon      lat
#> 1 92049 2.32048 48.81877
#> 2 92046 2.30161 48.82082

# Renvoie les coordonnees des centroides des communes de Montrouge (92049)
# et de Malakoff (92046) en geographie 2024.
codeComToCoord(codeInsee = c("92049","92046"),
               geo = "2024",
               type = "centroide")
#>    code     lon      lat
#> 1 92049 2.31649 48.81530
#> 2 92046 2.29693 48.81697

# Renvoie les coordonnees "point_on_surface" des communes de Montrouge (92049)
# et de Malakoff (92046) en geographie 2024.
codeComToCoord(codeInsee = c("92049","92046"),
               geo = "2024",
               type = "pos")
#>    code     lon      lat
#> 1 92049 2.31781 48.81533
#> 2 92046 2.30294 48.82013

# Renvoie les coordonnees des chefs-lieux des communes d'Ancteville (50007)
# et de Saint-Sauveur-Lendelin (50550) en geographie 2018.
codeComToCoord(codeInsee = c("50007","50550"),
               geo = "2018",
               type = "chx")
#>    code     lon      lat
#> 1 50007 -1.4802 49.10281
#> 2 50550 -1.4139 49.12958

# Au 01/01/2019, les communes d'Ancteville (50007),
# de Saint-Sauveur-Lendelin (50550) et autres communes
# ont fusionne pour former Saint-Sauveur-Villages (50550).

# Renvoie les coordonnees du chef-lieu de la commune
# de Saint-Sauveur-Villages (50550) en geographie 2019.
# et affiche un avertissement si le code commune est introuvable
# pour la geographie donnee.
codeComToCoord(codeInsee = c("50007","50550"),
               geo = "2019",
               type = "chx")
#> [WARNING] Il y a 1 commune non géolocalisée.
#> Veuillez vérifier que le millésime de la géographie des codes communes 
#> correspond bien à l'argument geo.
#> Liste des codes communes non géolocalisées : 
#> 50007
#>    code      lon      lat
#> 1 50550 -1.41349 49.13047