Extract countries, regions and cities from a URL or text
geograpy3 is a fork of geograpy2, which is itself a fork of geograpy and inherits most of it, but solves several problems (such as support for utf8, places names with multiple words, confusion over homonyms etc). Also, geograpy3 is compatible with Python 3, unlike geograpy2.
What it is
geograpy extracts place names from a URL or text, and add context to those names -- for example distinguishing between a country, region or city.
Install & Setup
Grab the package using
pip (this will take a few minutes)
pip install geograpy3
geograpy3 uses NLTK for entity recognition, so you'll also need to download the models we're using. Fortunately there's a command that'll take care of this for you.
Getting the source code
git clone https://github.com/somnathrakshit/geograpy3 cd geograpy3 scripts/install
Import the module, give some text or a URL, and presto.
import geograpy url = 'https://en.wikipedia.org/wiki/2012_Summer_Olympics_torch_relay' places = geograpy.get_geoPlace_context(url=url)
Now you have access to information about all the places mentioned in the linked article.
places.countriescontains a list of country names
places.regionscontains a list of region names
places.citiescontains a list of city names
places.otherlists everything that wasn't clearly a country, region or city
Note that the
other list might be useful for shorter texts, to pull out
information like street names, points of interest, etc, but at the moment is
a bit messy when scanning longer texts that contain possessive forms of proper
nouns (like "Russian" instead of "Russia").
But Wait, There's More
In addition to listing the names of discovered places, you'll also get some information about the relationships between places.
places.country_regionsregions broken down by country
places.country_citiescities broken down by country
places.address_stringscity, region, country strings useful for geocoding
Last But Not Least
While a text might mention many places, it's probably focused on one or two, so geograpy3 also breaks down countries, regions and cities by number of mentions.
Each of these returns a list of tuples. The first item in the tuple is the place name and the second item is the number of mentions. For example:
[('Russian Federation', 14), (u'Ukraine', 11), (u'Lithuania', 1)]
If You're Really Serious
You can of course use each of Geograpy's modules on their own. For example:
from geograpy import extraction e = extraction.Extractor(url='https://en.wikipedia.org/wiki/2012_Summer_Olympics_torch_relay') e.find_geoEntities() # You can now access all of the places found by the Extractor print(e.places)
Place context is handled in the
places module. For example:
from geograpy import places pc = places.PlaceContext(['Cleveland', 'Ohio', 'United States']) pc.set_countries() print pc.countries #['United States'] pc.set_regions() print(pc.regions #['Ohio']) pc.set_cities() print(pc.cities #['Cleveland']) print(pc.address_strings #['Cleveland, Ohio, United States'])
And of course all of the other information shown above (
is available after the corresponding
set_ method is called.
geograpy3 uses the following excellent libraries:
- NLTK for entity recognition
- newspaper for text extraction from HTML
- jellyfish for fuzzy text match
- pylodstorage for storage and retrieval of tabular data from SQL and SPARQL sources
geograpy3 uses the following data sources:
- GeoLite2 by MaxMind for city lookups
- ISO3166ErrorDictionary for common country mispellings via Sara-Jayne Terp
- pycountry for country/region lookups
- Wikidata for country/region/city information with disambiguation details like population/gdpPerCapita
Hat tip to Chris Albon for the name.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size geograpy3-0.1.24-py3-none-any.whl (1.5 MB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size geograpy3-0.1.24.tar.gz (1.4 MB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for geograpy3-0.1.24-py3-none-any.whl