{"id":18744031,"url":"https://github.com/at1as/geonames-graphql","last_synced_at":"2026-05-09T07:03:04.988Z","repository":{"id":45442338,"uuid":"182322830","full_name":"at1as/geonames-graphQL","owner":"at1as","description":"Geonames GraphQL server","archived":false,"fork":false,"pushed_at":"2022-12-08T05:00:11.000Z","size":22,"stargazers_count":0,"open_issues_count":6,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-28T19:48:05.199Z","etag":null,"topics":["flask","geonames","graphql","mysql","python","python3","sqlalchemy"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/at1as.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-19T20:37:55.000Z","updated_at":"2021-03-14T14:21:50.000Z","dependencies_parsed_at":"2023-01-24T16:01:02.920Z","dependency_job_id":null,"html_url":"https://github.com/at1as/geonames-graphQL","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/at1as%2Fgeonames-graphQL","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/at1as%2Fgeonames-graphQL/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/at1as%2Fgeonames-graphQL/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/at1as%2Fgeonames-graphQL/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/at1as","download_url":"https://codeload.github.com/at1as/geonames-graphQL/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239627300,"owners_count":19670844,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flask","geonames","graphql","mysql","python","python3","sqlalchemy"],"created_at":"2024-11-07T16:13:28.663Z","updated_at":"2025-11-22T01:30:14.902Z","avatar_url":"https://github.com/at1as.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Geonames GraphQL\n\nA graphQL server for the open source [geonames database](http://download.geonames.org/export/dump/)\n\nNote that this assumes you have already imported the database to MySQL. Most column configurations are determined dynamically, but you can verify your setup in [TABLE_STRUCTURE.sql](docs/TABLE_STRUCTURE.sql) or create it from scratch using that SQL file.\n\n```\nmysql\u003e show tables;\n+------------------------------+\n| Tables_in_geonames           |\n+------------------------------+\n| admin1_codes                 |\n| admin2_codes                 |\n| admin5_codes                 |\n| alternatenames               |\n| boundaries                   |\n| continent_codes              |\n| country_info                 |\n| feature_codes                |\n| geoname                      |\n| hierarchy                    |\n| iso_language_codes           |\n| postal_codes                 |\n| timezones                    |\n| usertags                     |\n+------------------------------+\n14 rows in set (0.01 sec)\n```\n\n### Filter Params\n```\n-geoname_id\n-name\n-asciiname\n-latitude\n-longitude\n-feature_class\n-feature_code\n-country_code\n-admin1_code\n-admin2_code\n-admin3_code\n-admin4_code\n-admin5_code\n-min_population\n-max_population\n```\n\n### Schema\nThe Geonames dataset provides a large amount of information. The schema follows the provided tables\n```\n{\n  geoname {\n    geonameId\n    name\n    asciiname\n    Alternatenames {\n      edges {\n        node {\n          alternatename\n          alternatenameId\n          isHistoric\n          isColloquial\n          isShortname\n          isPreferredName\n        }\n      }\n    }\n    latitude\n    longitude\n    featureClass\n    featureCode\n    countryCode\n    CountryInfo {\n      isoAlpha2\n      isoAlpha3\n      isoNumeric\n      fipsCode\n      name\n      capital\n      areaInSqKm\n      population\n      continent\n      tld\n      currency\n      currencyName\n      phone\n      postalCodeFormat\n      postalCodeRegex\n      languages\n      neighbours\n      equivalentFipsCode\n    }\n    cc2\n    admin1Code\n    Admin1Code{\n      code\n      asciiname\n    }\n    admin2Code\n    Admin2Code {\n      code\n      name\n      asciiname\n    }\n    admin3Code\n    admin4Code\n    admin5Code {\n      admin5Code\n    }\n    population\n    elevation\n    dem\n    timezone\n    modificationDate\n    children {\n      edges {\n        node {\n          #Full geoname object and all its properties available here\n          geonameId\n        }\n      }\n    }\n    parents {\n      edges {\n        node {\n          #Full geoname object and all its properties available here\n          geonameId\n        }\n      }\n    }\n  }\n}\n\n```\n\n### Running\n\nEnsure MySQL is running and then start the server:\n```\n❯ python3 app.py\n```\n\nNavigate your browser to localhost:5000 to use the interactive request builder, or use the API directly:\n```\ncurl 'http://localhost:5000/graphql?' --data '{\"query\":\"{\n    geoname(geonameId: 6115047) {\n      asciiname\n    }\n  }\",\n  \"variables\":null,\n  \"operationName\":null\n}'\n```\n\n### Sample Queries\n\nSee [EXAMPLES.md](docs/EXAMPLES.md)\n\n### Environemnt\n\n* Python 3.7.2\n* MacOS 10.13\n* MySQL 5.6.37\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fat1as%2Fgeonames-graphql","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fat1as%2Fgeonames-graphql","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fat1as%2Fgeonames-graphql/lists"}