Quick Start

Get City Coordinates

To get started, you can obtain a JSON file containing city coordinates from NLGeoCities. Here’s how to do it in Python:

from nl_ego_cities import city_coords

# Get the JSON file
cities = city_coords.city_json

# Access city coordinates
amsterdam_coords = cities["amsterdam"]
print(f"Coordinates of Amsterdam: latitude: {amsterdam_coords['lat']}, longitude: {amsterdam_coords['lon']}")

Processing DataFrame with get_lat_lon Function

If you have a DataFrame and want to add latitude and longitude columns using NLGeoCities, you can use the get_lat_lon function. Here’s how to do it:

from nl_ego_cities.load_city_data import get_lat_lon

# Assuming 'df' is your DataFrame with a 'city' column
df['city_lat'], df['city_lon'] = get_lat_lon(df, 'city', find_similar=False)

# Alternatively, to find similar city names if exact matches are not found
latitudes, longitudes = get_lat_lon(df, 'city', find_similar=True)

Note

The keys in the JSON file are lowercase. The find_similar parameter is optional and defaults to False. Set it to True if you want to find similar city names if exact matches are not found.

city_coords Data Structure

{
    "amsterdam": {
        "lat": 52.3676,
        "lon": 4.9041
    },
    "rotterdam": {
        "lat": 51.9225,
        "lon": 4.4792
    },
...
}