Skip to content
mkrouPublic

About

Golang parsing library for the geonames.org database dump

Topics

Resources

Stars

15 stars

Watchers

0 watching

Forks

Repository files navigation

Geonames

Golang parsing library for the geonames.org database dump.

Features

  • Parse data directly without downloading and unzipping
  • Read line by line with low memory consumption

Implemented data

status archive comment
✅ xx.zip GetGeonames; See readme
✅ admin1CodesASCII.txt GetAdminDivisions
✅ admin2Codes.txt GetAdminSubdivisions
✅ adminCode5.zip GetAdminCodes5
✅ allCountries.zip GetGeonames
⚠️ alternateNames.zip depricated, use alternateNamesV2.zip instead
✅ alternateNamesDeletes-xxxx-xx-xx.txt GetAlternateNameDeletes
✅ alternateNamesModifications-xxxx-xx-xx.txt GetAlternateNameModifications
✅ alternateNamesV2.zip GetAlternateNames
✅ alternatenames/xx.zip GetAlternateNames; See readme
✅ cities1000.zip GetGeonames
✅ cities15000.zip GetGeonames
✅ cities500.zip GetGeonames
✅ cities5000.zip GetGeonames
✅ countryInfo.txt GetCountries
✅ deletes-xxxx-xx-xx.txt GetDeletes
✅ featureCodes_bg.txt GetFeatureCodes
✅ featureCodes_en.txt GetFeatureCodes
✅ featureCodes_nb.txt GetFeatureCodes
✅ featureCodes_nn.txt GetFeatureCodes
✅ featureCodes_no.txt GetFeatureCodes
✅ featureCodes_ru.txt GetFeatureCodes
✅ featureCodes_sv.txt GetFeatureCodes
✅ hierarchy.zip GetHierarchy
✅ iso-languagecodes.txt GetLanguages
✅ modifications-xxxx-xx-xx.txt GetModifications
✅ no-country.zip GetGeonames
✅ shapes_all_low.zip GetShapes
⚠️ shapes_simplified_low.json.zip I don't see the point in geojson parsing
✅ timeZones.txt GetTimeZones
✅ userTags.zip GetUserTags

Installation

$ go get github.com/mkrou/geonames

Quick start

Parsing cities

package main

import (
    "fmt"
    "github.com/mkrou/geonames"
    "github.com/mkrou/geonames/models"
    "log"
)

func main() {
    p := geonames.NewParser()
    
    //print all cities with a population greater than 5000
    err := p.GetGeonames(geonames.Cities5000, func(geoname *models.Geoname) error {
    fmt.Println(geoname.Name)
        return nil
    })
    if err != nil {
        log.Fatal(err)
    }
}

Parsing alternames

package main

import (
    "fmt"
    "github.com/mkrou/geonames"
    "github.com/mkrou/geonames/models"
    "log"
)
func main() {
    p := geonames.NewParser()
    
    err := p.GetAlternateNames(geonames.AlternateNames, func(geoname *models.AlternateName) error {
        fmt.Println(geoname.Name)
        return nil
    })
    if err != nil {
        log.Fatal(err)
    }
}

Parsing alphabetical list of archives

package main

import (
    "fmt"
    "github.com/mkrou/geonames"
    "github.com/mkrou/geonames/models"
    "log"
)
func main() {
    p := geonames.NewParser()
    
    err := p.GetGeonames("AD.zip", func(geoname *models.Geoname) error {
        fmt.Println(geoname.Name)
        return nil
    })
    if err != nil {
        log.Fatal(err)
    }
    
    err = p.GetAlternateNames("alternames/AD.zip", func(geoname *models.AlternateName) error {
        fmt.Println(geoname.Name)
        return nil
    })
    if err != nil {
        log.Fatal(err)
    }
}

About

Golang parsing library for the geonames.org database dump

Topics

Resources

Stars

15 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages