geoname-enrichment

This Python script reads placenames from CSV files and queries a custom API on top of geonames data to enrich the geoname identifier.

https://github.com/metabelgica/geoname-enrichment

Science Score: 54.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (8.6%) to scientific vocabulary
Last synced: 10 months ago · JSON representation ·

Repository

This Python script reads placenames from CSV files and queries a custom API on top of geonames data to enrich the geoname identifier.

Basic Info
  • Host: GitHub
  • Owner: MetaBelgica
  • License: mit
  • Language: Python
  • Default Branch: main
  • Size: 13.7 KB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 1
Created over 1 year ago · Last pushed over 1 year ago
Metadata Files
Readme Changelog License Citation

README.md

Geoname Enrichment

This Python script reads placenames from CSV files and queries a custom API on top of geonames data to enrich the geoname identifier. The API and geonames database are available under Open Licenses at:

Usage via the command line

Create and activate a Python virtual environment ```bash

Create a new Python virtual environment

python3 -m venv py-geo-env

Activate the virtual environment

source py-geo-env/bin/activate

Install dependencies

pip -r requirements.txt

install the tool

pip install . ```

Available options

``` usage: geonameenrichment.py [-h] -c CONFIGFILE -p PLACENAMECOLUMN --countryname-column COUNTRYNAMECOLUMN --id-column IDCOLUMN -o OUTPUTFILE [-l LOGFILE] [-L LOGLEVEL] inputFile

This script reads names of places, possibly in combination with countries, and looks up the values in a local geonames-based API

positional arguments: inputFile The input file containing CSV records

optional arguments: -h, --help show this help message and exit -c CONFIGFILE, --config-file CONFIGFILE The config file with instructions how to enrich the location data -p PLACENAMECOLUMN, --placename-column PLACENAMECOLUMN The name of the column in the input CSV that contains the name of the place --countryname-column COUNTRYNAMECOLUMN The name of the column in the input CSV that contains the country name --id-column IDCOLUMN The name of the column in the input CSV that contains the row identifier -o OUTPUTFILE, --output-file OUTPUTFILE The output CSV file containing descriptive keys based on the key composition config -l LOGFILE, --log-file LOGFILE The optional name of the logfile -L LOGLEVEL, --log-level LOGLEVEL The log level, default is INFO ```

Owner

  • Name: MetaBelgica
  • Login: MetaBelgica
  • Kind: organization
  • Email: Sven.Lieber@kbr.be
  • Location: Belgium

Open source code related to the infastructure project MetaBelgica that aims to publish Linked Open Data about entities related to Belgian cultural heritage.

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Lieber"
  given-names: "Sven"
  orcid: "https://orcid.org/0000-0002-7304-3787"
title: "Geoname enrichment"
version: 0.1.0
date-released: 2025-02-17
url: "https://github.com/metabelgica/geoname-enrichment"

GitHub Events

Total
  • Push event: 1
  • Public event: 1
  • Create event: 1
Last Year
  • Push event: 1
  • Public event: 1
  • Create event: 1

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 6 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 1
  • Total maintainers: 1
pypi.org: geoname-enrichment

A Python script to enrich placenames in a CSV file with geoname data from a custom API.

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 6 Last month
Rankings
Dependent packages count: 9.4%
Average: 31.1%
Dependent repos count: 52.8%
Maintainers (1)
Last synced: 11 months ago

Dependencies

setup.py pypi