Skip to content

❗ This is a read-only mirror of the CRAN R package repository. placematchr — Normalize and Match City Names to NUTS Regions

License

Notifications You must be signed in to change notification settings

cran/placematchr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

placematchr: Robust City Normalization and NUTS Matching for Europe

placematchr is an R package designed to normalize city names and map them to standard NUTS 3 and LAU (Local Administrative Units) codes across 32 European countries.

It is widely used to harmonize messy geographical data (survey responses, address lists) with official regional identifiers for analysis.

Key Features

  • Broad Coverage: Supports all EU/EEA countries
  • English Exonym Support: Handles common English names for major cities (e.g., "Munich" matches "München", "Prague" matches "Praha", "Florence" matches "Firenze", "Cologne" matches "Köln").
  • Robust Suburb Handling:
    • Normalizes suburb suffixes (e.g., "Garching b. München" -> "Garching", "Champs-sur-Marne" -> "Champs").
    • Correctly disambiguates complex cases like "Frankfurt (Oder)" vs "Frankfurt am Main".
    • Handles article inversions in Spanish/French (e.g., "Rozas, Las" -> "Las Rozas").
  • Cascading Matching Logic:
    1. Exact NUTS Match: Checks if the normalized input matches a NUTS 3 region name directly (e.g., "Berlin").
    2. Exact LAU Match: Checks if it matches a Local Administrative Unit (e.g., "Garching").
    3. Fuzzy LAU Match: Fuzzy string matching for slight variations (e.g., typos).
    4. Fuzzy NUTS Match: Fallback to fuzzy NUTS identification.
  • Zero-Config Data: All necessary geographical data (NUTS/LAU tables) is processed and bundled with the package.

Usage

Basic Matching

library(placematchr)

# Match a single city in Germany
match_city("Munich", country = "DE")
# Returns data frame with NUTS_ID: DE212, Name: München, Landeshauptstadt

# Match a list of cities in Italy
cities <- c("Rome", "Milan", "Naples", "Venice")
match_city(cities, country = "IT")

Handling Suburbs and Variations

# Input: "Garching b. München" (Suburb)
# Result: Matches "Garching" (LAU). Mapped to Munich District (NUTS).
match_city("Garching b. München", country = "DE")

# Input: "Champs-sur-Marne" (French Suburb)
# Result: Matches "Champs" (LAU).
match_city("Champs-sur-Marne", country = "FR")

Supported Countries

BE, BG, CZ, DK, DE, EE, IE, EL, ES, FR, HR, IT, CY, LV, LT, LU, HU, MT, NL, AT, PL, PT, RO, SI, SK, FI, SE, LI, NO, CH, MK, TR, UK.

License

MIT

About

❗ This is a read-only mirror of the CRAN R package repository. placematchr — Normalize and Match City Names to NUTS Regions

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages