{"id":19422061,"url":"https://github.com/azavea/python-omgeo","last_synced_at":"2025-04-24T15:31:45.852Z","repository":{"id":2682594,"uuid":"3675032","full_name":"azavea/python-omgeo","owner":"azavea","description":"OMGeocoder - A python geocoding abstraction layer","archived":false,"fork":false,"pushed_at":"2024-04-19T15:55:41.000Z","size":1123,"stargazers_count":36,"open_issues_count":13,"forks_count":12,"subscribers_count":37,"default_branch":"develop","last_synced_at":"2024-06-11T18:39:12.974Z","etag":null,"topics":["geocode","geocoder","geocoding","python"],"latest_commit_sha":null,"homepage":"http://python-omgeo.readthedocs.io/en/latest/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/azavea.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.rst","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-03-09T21:31:15.000Z","updated_at":"2024-06-21T15:34:34.859Z","dependencies_parsed_at":"2024-06-21T15:34:33.285Z","dependency_job_id":"019658de-6ab2-42e5-84e8-8a3290aaa248","html_url":"https://github.com/azavea/python-omgeo","commit_stats":{"total_commits":272,"total_committers":15,"mean_commits":"18.133333333333333","dds":0.4227941176470589,"last_synced_commit":"329beedb0c19b7b98b2754f68f316022a49da82f"},"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azavea%2Fpython-omgeo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azavea%2Fpython-omgeo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azavea%2Fpython-omgeo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azavea%2Fpython-omgeo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/azavea","download_url":"https://codeload.github.com/azavea/python-omgeo/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250654325,"owners_count":21465862,"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":["geocode","geocoder","geocoding","python"],"created_at":"2024-11-10T13:32:03.999Z","updated_at":"2025-04-24T15:31:45.444Z","avatar_url":"https://github.com/azavea.png","language":"Python","readme":"**OMGeo - Python Edition**\n\n``python-omgeo`` is a geocoding abstraction layer written in python.  Currently\nsupported geocoders:\n\n* `US Census Geocoder \u003chttps://www.census.gov/geo/maps-data/data/geocoder.html\u003e`_\n* `Bing Maps REST Locations API \u003chttp://msdn.microsoft.com/en-us/library/ff701715.aspx\u003e`_\n* `ESRI World Geocoding Service \u003chttp://resources.arcgis.com/en/help/arcgis-online-geocoding-rest-api/\u003e`_\n* `MapQuest Licensed Data API \u003chttp://developer.mapquest.com/web/products/dev-services/geocoding-ws\u003e`_\n* `MapQuest-hosted Nominatim Open Data API \u003chttp://developer.mapquest.com/web/products/open/geocoding-service\u003e`_\n* `Pelias geocoder \u003chttps://pelias.io/\u003e`_. Defaults to use `geocode.earth \u003chttps://geocode.earth/\u003e`_\n* `Google geocoder \u003chttps://developers.google.com/maps/documentation/geocoding/intro\u003e`_\n\n.. NOTE::\n   Check out `this project's page on GitHub \u003chttps://github.com/azavea/python-omgeo/\u003e`_.\n\n**Installation**::\n\n    sudo pip install python-omgeo\n\n**Documentation**\n\nDocs are available in `HTML \u003chttp://python-omgeo.readthedocs.org/en/latest/\u003e`_\nor `PDF \u003chttp://media.readthedocs.org/pdf/python-omgeo/latest/python-omgeo.pdf\u003e`_ format.\n\n**Usage Example**\n\nMake a new geocoder and geocode and address::\n\n    \u003e\u003e\u003e from omgeo import Geocoder\n    \u003e\u003e\u003e g = Geocoder()\n    \u003e\u003e\u003e result = g.geocode('340 12th St, Philadelphia PA')\n\nTake a look at the result::\n\n    \u003e\u003e\u003e result\n    {'candidates': [\n      \u003c340 S 12th St, Philadelphia, PA, 19107 (-75.161461, 39.94532) EsriWGS\u003e,\n      \u003c340 N 12th St, Philadelphia, PA, 19107 (-75.158434, 39.958728) EsriWGS\u003e\n     ],\n     'upstream_response_info': [\u003cEsriWGS 1054ms\u003e]}\n\nTake a closer look at the information in our address Candidate objects::\n\n    \u003e\u003e\u003e [c.__dict__ for c in result[\"candidates\"]]\n\t[{'geoservice': 'EsriWGS',\n\t  'locator': u'USA.AddressPoint',\n\t  'locator_type': u'PointAddress',\n\t  'match_addr': u'340 S 12th St, Philadelphia, PA, 19107',\n\t  'score': 90.87,\n\t  'wkid': 4326,\n\t  'x': -75.161461,\n\t  'y': 39.94532},\n\t {'geoservice': 'EsriWGS',\n\t  'locator': 'interpolation',\n\t  'locator_type': u'StreetAddress',\n\t  'match_addr': u'340 N 12th St, Philadelphia, PA, 19107',\n\t  'score': 90.87,\n\t  'wkid': 4326,\n\t  'x': -75.158434,\n\t  'y': 39.958728}]\n\nSome geocoders (EsriWGS and US Census) can return address components in addition to the\nfull address::\n\n    \u003e\u003e\u003e [{'geoservice': 'EsriWGS',\n        'locator': 'interpolation',\n        'locator_type': u'StreetAddress',\n        'match_addr': u'340 N 12th St, Phila, Pennsylvania, 19107',\n        'match_city': u'Phila',\n        'match_country': u'USA',\n        'match_postal': u'19107',\n        'match_region': u'Pennsylvania',\n        'match_streetaddr': u'340 N 12th St',\n        'match_subregion': u'',\n        'score': 90.1,\n        'wkid': 4326,\n        'x': -75.158384,\n        'y': 39.958774}]\n\nThese are optional; their existence may change depending on the response from the geocoder.\n\n**Testing**\n\nThere is a shell script in the root of the repository called *test.dummy.sh*.\nCopy it using ``cp test.dummy.sh test.sh``. Edit *test.sh* to include the\nAPI keys that you obtained from the given geocoding service providers. Then, run\nthe tests using ``./test.sh``.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazavea%2Fpython-omgeo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazavea%2Fpython-omgeo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazavea%2Fpython-omgeo/lists"}