{"id":22749886,"url":"https://github.com/davidkowalk/twitter_geolocate","last_synced_at":"2025-10-19T05:54:10.628Z","repository":{"id":183525306,"uuid":"352718993","full_name":"davidkowalk/twitter_geolocate","owner":"davidkowalk","description":"Search twitter by address. Due to the ongoing situation at twitter this repository is not currently being maintained.","archived":false,"fork":false,"pushed_at":"2021-06-18T10:41:37.000Z","size":20,"stargazers_count":30,"open_issues_count":2,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-28T02:01:41.392Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/davidkowalk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-03-29T16:56:26.000Z","updated_at":"2024-11-27T15:21:03.000Z","dependencies_parsed_at":"2023-07-24T23:01:45.175Z","dependency_job_id":null,"html_url":"https://github.com/davidkowalk/twitter_geolocate","commit_stats":null,"previous_names":["davidkowalk/twitter_geolocate"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidkowalk%2Ftwitter_geolocate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidkowalk%2Ftwitter_geolocate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidkowalk%2Ftwitter_geolocate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidkowalk%2Ftwitter_geolocate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidkowalk","download_url":"https://codeload.github.com/davidkowalk/twitter_geolocate/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248885306,"owners_count":21177618,"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":[],"created_at":"2024-12-11T04:11:07.166Z","updated_at":"2025-10-19T05:54:05.593Z","avatar_url":"https://github.com/davidkowalk.png","language":"Python","funding_links":["https://img.buymeacoffee.com/button-api/?text=Buy","https://www.buymeacoffee.com/davidkowalk"],"categories":["Miscellaneous links"],"sub_categories":["**PHP**"],"readme":"[\u003cimg src=\"https://img.buymeacoffee.com/button-api/?text=Buy Me A Coffee!\u0026emoji=☕\u0026slug=davidkowalk\u0026button_colour=FF5F5F\u0026font_colour=ffffff\u0026font_family=Arial\u0026outline_colour=000000\u0026coffee_colour=FFDD00\"\u003e](https://www.buymeacoffee.com/davidkowalk)\n\n# Twitter Geolocate\nTwitter Geolocation is a console app that generates twitter search querries for a certain geolocation and opens them in your standard webbrowser. Provide either GPS Coordinates, a What3Words-address (requires a free account) or use the mapquest API to search for a location (requires a free account).\n\n## Usage\n\nAs a python script this does not need to be installed but to run it you will require python 3.7 or higher and the following packages:\n\n- requests\n- json*\n- webbrowser*\n\n\\* = should be provided with python3\n\n## Search by coordinates\n\n```\n$ python3 geolocate.py -c \u003clatitude\u003e \u003clongitude\u003e \u003cradius\u003e\n```\n\nExample:\n```\n$ python3 geolocate.py -c 52.5186202 13.3761872 0.2km\n```\n\n## Search by What3Words address.\n\nTo use the \"What3Words\" api you will ned an api key provided with a free account which will grant you 1000 requests per month.\n\nYou can read more here: https://developer.what3words.com/public-api\n\nOnce you have an api key you can use it to search to convert a querry to coordinates.\n\n```\n$ python3 geolocate.py -w \u003ckey\u003e \u003cquerry\u003e \u003cradius\u003e\n```\n\nThe three-word-address will automatically be converted to the corresponding coordinates on the southwest corner of the square.\n\nIf no key is provided in the console the script will look for a file `wordkey.txt` in the current folder and read the first line of that file as a key. If no file is found it will throw an error.\n\n```\n$ python3 geolocate.py -w \u003cquerry\u003e \u003cradius\u003e\n```\n\nExample:\n```\n$ python3 geolocate.py -w myKey cover.crumble.hint 0.3km\n$ python3 geolocate.py -w cover.crumble.hint 0.3km\n```\n\n## Search addresses with mapquest\n\nTo use the mapquest api you will need an api key provided with a free account which will grant you 15000 requests per month (which are about 20 per hour if you use the service 24 hours per day)\n\nYou can read more here: https://developer.mapquest.com/documentation/\n\nOnce you have an api key you can use it to search for places.\n\n```\n$ python3 gelocate.py -q \u003ckey\u003e \u003cquerry\u003e \u003cradius\u003e\n```\n\nThe program will then ask you to select one of the top 5 search results. If only one result is found it will be automatically selected.\n\nExample:\n```\n$ python3 geolocate.py -q myKey \"Platz der Republik 1, 11011 Berlin\" 0.3km\nSearch Results:\n\n(1) Käfer Dachgarten-Restaurant im Deutschen Bundestag, 1, Platz der Republik, Tiergarten, Mitte, Berlin, 11011, Deutschland\n(2) Deutscher Bundestag, 1, Platz der Republik, Tiergarten, Mitte, Berlin, 11011, Deutschland\n\nPlease select an option or type \"exit\" to exit\n\u003e\n\n```\n\nIf no key is provided in the console the script will look for a file `mapkey.txt` in the same folder and read the first line of that file as a key. If no file is found it will throw an error.\n\n```\n$ python3 geolocate.py -q \u003cquerry\u003e \u003cradius\u003e\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidkowalk%2Ftwitter_geolocate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidkowalk%2Ftwitter_geolocate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidkowalk%2Ftwitter_geolocate/lists"}