{"id":19715788,"url":"https://github.com/davidesantangelo/geoplugin","last_synced_at":"2025-04-29T20:30:41.203Z","repository":{"id":30489328,"uuid":"34043454","full_name":"davidesantangelo/geoplugin","owner":"davidesantangelo","description":"This is a Ruby wrapper library around the API provided by Geoplugin (http://www.geoplugin.com).","archived":false,"fork":false,"pushed_at":"2019-03-12T16:28:07.000Z","size":13,"stargazers_count":9,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-15T14:51:21.458Z","etag":null,"topics":["geolocation","ruby","ruby-wrapper-library","rubygem"],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/davidesantangelo.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":"2015-04-16T08:23:23.000Z","updated_at":"2022-01-08T08:59:42.000Z","dependencies_parsed_at":"2022-08-20T10:11:00.897Z","dependency_job_id":null,"html_url":"https://github.com/davidesantangelo/geoplugin","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/davidesantangelo%2Fgeoplugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidesantangelo%2Fgeoplugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidesantangelo%2Fgeoplugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidesantangelo%2Fgeoplugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidesantangelo","download_url":"https://codeload.github.com/davidesantangelo/geoplugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251578268,"owners_count":21612005,"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":["geolocation","ruby","ruby-wrapper-library","rubygem"],"created_at":"2024-11-11T22:39:24.345Z","updated_at":"2025-04-29T20:30:40.885Z","avatar_url":"https://github.com/davidesantangelo.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Geoplugin\n\nThis is a Ruby wrapper library around the API provided by \u003ca target=\"_BLANK\" href=\"http://www.geoplugin.com\"\u003eGeoplugin\u003c/a\u003e. Geoplugin is the easiest way for you to know where your visitors are from so that you can provide them with content more relevant to their geographical location. \n\n## See it in action!\n\nYou can try Geoplugin live at this little demo: [https://geopweb.herokuapp.com](https://geopweb.herokuapp.com)\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'geoplugin'\n```\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install geoplugin\n\n## Usage\n\n```ruby\nrequire 'geoplugin'\n\n# Find my location without ssl\nlocation = Geoplugin.me\n\n# Find my location with ssl\nlocation = Geoplugin.me(:ssl =\u003e true, :key =\u003e 'your geoplugin key')\n\n# Find ip location with ssl\nlocation = Geoplugin.new('8.8.8.8')\n\n# Find my location with ssl\nlocation = Geoplugin.new('8.8.8.8', :ssl =\u003e true, :key =\u003e 'your geoplugin key')\n\n#Like all calls to any of geoPlugin's web services, the default base_currency is USD ($US). \n#Thus, if your base currency is NOT $US, then you must add the variable base_currency=XXX to the call like this:\n\nlocation = Geoplugin.new('151.72.254.22', :base_currency =\u003e \"EUR\")\nlocation = Geoplugin.me(:base_currency =\u003e \"EUR\")\n\n```\n\n\u003ci\u003eTo use the SSL web services, \u003ca href=\"http://www.geoplugin.com/premium#ssl_access_per_year\" target=\"_BLANK\"\u003ean inexpensive key is required. \u003c/a\u003e\u003c/i\u003e\n## Attributes\n\nrequest, \nstatus, \ncity, \nregion, \nareacode, \ndmacode, \ncountrycode, \ncountryname, \ncontinentcode, \nlatitude, \nlongitude, \nregioncode, \nregionname, \ncurrencycode, \ncurrencysymbol, \ncurrencysymbol_utf, \ncurrencyconverter\n\n## Credits\nMany thanks to Geoplugin for his implementation of the API. \nGeoplugin includes GeoLite data created by MaxMind, available from\n\u003ca href=\"http://www.maxmind.com\"\u003ehttp://www.maxmind.com\u003c/a\u003e.\n\n## License\nThe restcountry GEM is released under the MIT License.\n\n## Contributing\n\n1. Fork it ( https://github.com/[my-github-username]/geoplugin/fork )\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create a new Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidesantangelo%2Fgeoplugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidesantangelo%2Fgeoplugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidesantangelo%2Fgeoplugin/lists"}