{"id":15830163,"url":"https://github.com/astrapi69/jgeohash","last_synced_at":"2025-04-16T01:19:57.293Z","repository":{"id":5746759,"uuid":"6959258","full_name":"astrapi69/jgeohash","owner":"astrapi69","description":"An easy-to-implement library for the GeoHash algorithm","archived":false,"fork":false,"pushed_at":"2021-11-09T11:27:29.000Z","size":1066,"stargazers_count":66,"open_issues_count":0,"forks_count":26,"subscribers_count":8,"default_branch":"develop","last_synced_at":"2024-10-12T11:14:47.000Z","etag":null,"topics":["geohash","geohash-algorithm","geohash-cells","geohash-values","java","latitude","longitude","merge-sections"],"latest_commit_sha":null,"homepage":"http://astrapi69.github.io/jgeohash","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/astrapi69.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"astrapi69","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://flattr.com/@astrapi69"]}},"created_at":"2012-12-01T20:50:36.000Z","updated_at":"2024-09-07T20:45:42.000Z","dependencies_parsed_at":"2022-09-26T22:01:20.149Z","dependency_job_id":null,"html_url":"https://github.com/astrapi69/jgeohash","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astrapi69%2Fjgeohash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astrapi69%2Fjgeohash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astrapi69%2Fjgeohash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astrapi69%2Fjgeohash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/astrapi69","download_url":"https://codeload.github.com/astrapi69/jgeohash/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249178985,"owners_count":21225469,"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":["geohash","geohash-algorithm","geohash-cells","geohash-values","java","latitude","longitude","merge-sections"],"created_at":"2024-10-05T11:05:07.666Z","updated_at":"2025-04-16T01:19:57.259Z","avatar_url":"https://github.com/astrapi69.png","language":"Java","funding_links":["https://ko-fi.com/astrapi69","https://flattr.com/@astrapi69","https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=GVBTWLRAZ7HB8","https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=MJ7V43GU2H386"],"categories":[],"sub_categories":[],"readme":"# Overview\n\u003cdiv style=\"text-align: center\"\u003e\n\n[![build status](https://travis-ci.com/astrapi69/jgeohash.svg?branch=master)](https://travis-ci.com/astrapi69/jgeohash)\n[![Java CI build and test](https://github.com/astrapi69/jgeohash/actions/workflows/build-test.yml/badge.svg)](https://github.com/astrapi69/jgeohash/actions/workflows/build-test.yml)\n[![Coverage Status](https://codecov.io/gh/astrapi69/jgeohash/branch/develop/graph/badge.svg)](https://codecov.io/gh/astrapi69/jgeohash)\n[![Coverage Status](https://coveralls.io/repos/github/astrapi69/jgeohash/badge.svg?branch=develop)](https://coveralls.io/github/astrapi69/jgeohash?branch=develop)\n[![open issues](https://img.shields.io/github/issues/astrapi69/jgeohash.svg?style=flat)](https://github.com/astrapi69/jgeohash/issues)\n[![license apache2](https://img.shields.io/badge/license-apache2-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0)\n[![Donate](https://img.shields.io/badge/donate-❤-ff2244.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=GVBTWLRAZ7HB8)\n\n\u003c/div\u003e\n\nAn easy-to-implement library that can assist Java developers in using the [GeoHash](https://en.wikipedia.org/wiki/Geohash) algorithm in order to create geocodes based on custom latitude and longitude values.\n\nWith the help of jGeohash, Java developers will be able to quickly and easily generate a geohash code using user-defined latitude and longitude values. By using the GeoHash algorithm, the space can be divided into multiple grid shapes.\n\nThis library is a basic implementation from the GeoHash algorithm written in the java and can be applied to generate from the latitude and longitude a geohash code and reverse.\n\nThe library is kept simple and have no dependencies to other libraries.\n\n\n\u003e Please support this project by simply putting a Github \u003c!-- Place this tag where you want the button to render. --\u003e\n                                                         \u003ca class=\"github-button\" href=\"https://github.com/astrapi69/jgeohash\" data-icon=\"octicon-star\" aria-label=\"Star astrapi69/jgeohash on GitHub\"\u003eStar ⭐\u003c/a\u003e. Share this library with friends on Twitter and everywhere else you can.\nIf you love this project [![donation](https://img.shields.io/badge/donate-❤-ff2244.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=GVBTWLRAZ7HB8)\n   \n## Note\n\nNo animals were harmed in the making of this library.\n\n# Donations\n\nThis project is kept as an open source product and relies on contributions to remain being\ndeveloped. If you like this library, please consider a donation\n\nover paypal: \u003cbr\u003e\u003cbr\u003e\n\u003ca href=\"https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=MJ7V43GU2H386\" target=\"_blank\"\u003e\n\u003cimg src=\"https://www.paypalobjects.com/en_US/GB/i/btn/btn_donateCC_LG.gif\" alt=\"PayPal this\" title=\"PayPal – The safer, easier way to pay online!\" style=\"border: none\" /\u003e\n\u003c/a\u003e\n\u003cbr\u003e\u003cbr\u003e\nor over bitcoin(BTC) with this address:\n\nbc1ql2y99q7e8psndhcc3gferk03esw3qqf677rhjy\n\n\u003cimg src=\"https://github.com/astrapi69/jgeohash/blob/master/src/main/resources/img/bc1ql2y99q7e8psndhcc3gferk03esw3qqf677rhjy.png\" \nalt=\"Donation Bitcoin Wallet\" width=\"250\"/\u003e\n\nor over FIO with this address:\n\nFIO7tFMUVAA9cHiPPqKMfMXiSxHrbpiFyRYqTketNuM67aULuwjop\n\n\u003cimg src=\"https://github.com/astrapi69/jgeohash/blob/master/src/main/resources/img/FIO7tFMUVAA9cHiPPqKMfMXiSxHrbpiFyRYqTketNuM67aULuwjop.png\" \nalt=\"Donation FIO Wallet\" width=\"250\"/\u003e\n\nor over Ethereum(ETH) with:\n\n0xc057D159D3C8f3311E73568b334FF6fE82EB2b7D\n\n\u003cimg src=\"https://github.com/astrapi69/jgeohash/blob/master/src/main/resources/img/0xc057D159D3C8f3311E73568b334FF6fE82EB2b7D.png\" \nalt=\"Donation Ethereum Wallet\" width=\"250\"/\u003e\n\nor over Ethereum Classic(ETC) with:\n\n0xF708cA86D86C246B69c3F4BAe431eBbe0c2bfddD\n\n\u003cimg src=\"https://github.com/astrapi69/jgeohash/blob/master/src/main/resources/img/0xF708cA86D86C246B69c3F4BAe431eBbe0c2bfddD.png\" \nalt=\"Donation Ethereum Classic Wallet\" width=\"250\"/\u003e\n\nor over Dogecoin(DOGE) with:\n\nD5yi4Um8cpakd6yPRm2hGWuQ5nrVzhSSW1\n\n\u003cimg src=\"https://github.com/astrapi69/jgeohash/blob/master/src/main/resources/img/D5yi4Um8cpakd6yPRm2hGWuQ5nrVzhSSW1.png\" \nalt=\"Donation Dogecoin Wallet\" width=\"250\"/\u003e\n\nor over Monero(XMR) with:\n\n49bqeRQ7Bf49oJFVC72pqpe5hFbb62pfXDYPdLsadGGF81KZW2ZfrPZ8PbAVu5X2v1TYAspeczMya3cYQysNS4usRRPQHVw\n\n\u003cimg src=\"https://github.com/astrapi69/jgeohash/blob/master/src/main/resources/img/49bqeRQ7Bf49oJFVC72pqpe5hFbb62pfXDYPdLsadGGF81KZW2ZfrPZ8PbAVu5X2v1TYAspeczMya3cYQysNS4usRRPQHVw.png\" \nalt=\"Donation Monero Wallet\" width=\"250\"/\u003e\n\nor over flattr:\n  \n\u003ca href=\"http://flattr.com/thing/4067696/astrapi69jgeohash-on-GitHub\" target=\"_blank\"\u003e\n\u003cimg src=\"http://api.flattr.com/button/flattr-badge-large.png\" alt=\"Flattr this\" title=\"Flattr this\"  style=\"border: none\" /\u003e\n\u003c/a\u003e\n\n## Key features:\n\n1. Very small size (\u003c35Kb)\n2. Can get the adjacent geohash area from the given direction\n3. Can get the geohash from an ip address\n4. Can calculate distance between two geohash values in various measuring units like miles, km, meters\n5. Can get the geohash cells around from the first, second or thrird ring from a given geohash cell\n\n## License\n\nThe source code comes under the liberal Apache License V2.0, making jgeohash great for all types of applications.\n\n## Maven Central\n\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/de.alpharogroup/jgeohash-core/badge.svg)](https://maven-badges.herokuapp.com/maven-central/de.alpharogroup/jgeohash-core) jgeohash-core \n\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/de.alpharogroup/jgeohash-geoip/badge.svg)](https://maven-badges.herokuapp.com/maven-central/de.alpharogroup/jgeohash-geoip) jgeohash-geoip\n\n## javadoc\n\n[![Javadocs](http://www.javadoc.io/badge/de.alpharogroup/jgeohash.svg)](http://www.javadoc.io/doc/de.alpharogroup/jgeohash-core) jgeohash-core \n\n[![Javadocs](http://www.javadoc.io/badge/de.alpharogroup/jgeohash.svg)](http://www.javadoc.io/doc/de.alpharogroup/jgeohash-geoip) jgeohash-geoip \n\n## javadoc\n\njgeohash-core [![Javadocs](http://www.javadoc.io/badge/de.alpharogroup/jgeohash.svg)](http://www.javadoc.io/doc/de.alpharogroup/jgeohash-core)\n\njgeohash-geoip [![Javadocs](http://www.javadoc.io/badge/de.alpharogroup/jgeohash.svg)](http://www.javadoc.io/doc/de.alpharogroup/jgeohash-geoip)\n\n## Maven dependency\n\nMaven dependency is now on sonatype.\nCheck out [sonatype repository](https://oss.sonatype.org/index.html#nexus-search;quick~jgeohash) for latest snapshots and releases.\n\nYou can add the following maven dependencies to your project `pom.xml` if you want to import the library. \n\nYou can first define the version properties:\n\n\t\u003cproperties\u003e\n\t\t...\n\t\t\u003c!-- JGEOHASH version --\u003e\n\t\t\u003cjgeohash.version\u003e2.5.2\u003c/jgeohash.version\u003e\n\t\t\u003cjgeohash-core.version\u003e${jgeohash.version}\u003c/jgeohash-core.version\u003e\n\t\t\u003cjgeohash-geoip.version\u003e${jgeohash.version}\u003c/jgeohash-geoip.version\u003e\n\t\t...\n\t\u003c/properties\u003e\n\nAdd the following maven dependency to your project `pom.xml` if you want to import the core functionality of jgeohash:\n\n\t\t\u003cdependencies\u003e\n\t\t\t...\n            \u003c!-- JGEOHASH-CORE DEPENDENCY --\u003e\n\t\t\t\u003cdependency\u003e\n\t\t\t\t\u003cgroupId\u003ede.alpharogroup\u003c/groupId\u003e\n\t\t\t\t\u003cartifactId\u003ejgeohash-core\u003c/artifactId\u003e\n\t\t\t\t\u003cversion\u003e${jgeohash-core.version}\u003c/version\u003e\n\t\t\t\u003c/dependency\u003e\n\t\t\u003c/dependencies\u003e\n\nAdd the following maven dependency to your project `pom.xml` if you want to import the geoip functionality of jgeohash:\n\n\t\t\u003cdependencies\u003e\n\t\t\t...\n            \u003c!-- JGEOHASH-GEOIP DEPENDENCY --\u003e\n\t\t\t\u003cdependency\u003e\n\t\t\t\t\u003cgroupId\u003ede.alpharogroup\u003c/groupId\u003e\n\t\t\t\t\u003cartifactId\u003ejgeohash-geoip\u003c/artifactId\u003e\n\t\t\t\t\u003cversion\u003e${jgeohash-geoip.version}\u003c/version\u003e\n\t\t\t\u003c/dependency\u003e\n\t\t\u003c/dependencies\u003e\n\n## Semantic Versioning\n\nThe versions of jgeohash are maintained with the Semantic Versioning guidelines.\n\nRelease version numbers will be incremented in the following format:\n\n`\u003cmajor\u003e.\u003cminor\u003e.\u003cpatch\u003e`\n\nFor detailed information on versioning for this project you can visit this [wiki page](https://github.com/lightblueseas/mvn-parent-projects/wiki/Semantic-Versioning).\n\n## Want to Help and improve it? ###\n\nThe source code for jGeohash are on GitHub. Please feel free to fork and send pull requests!\n\nCreate your own fork of [astrapi69/jgeohash/fork](https://github.com/astrapi69/jgeohash/fork)\n\nTo share your changes, [submit a pull request](https://github.com/astrapi69/jgeohash/pull/new/develop).\n\nDon't forget to add new units tests on your changes.\n\n## Contacting the Developer\n\nDo not hesitate to contact the jgeohash developers with your questions, concerns, comments, bug reports, or feature requests.\n- Feature requests, questions and bug reports can be reported at the [issues page](https://github.com/astrapi69/jgeohash/issues).\n\n## Examples\n\n  * [SpatialDataQueries][SpatialDataQueries]\n  * [Simple-example][Simple-example]\n  * [Hibernate-example][Hibernate-example]\n\n   [SpatialDataQueries]: https://github.com/astrapi69/jgeohash/wiki/Adding-spatial-data-queries-to-Phoenix-on-HBase \"Adding spatial data queries to Phoenix on HBase\"\n   [Simple-example]: https://github.com/astrapi69/jgeohash/wiki/Simple-example \"Simple-example\"\n   [Hibernate-example]: https://github.com/astrapi69/jgeohash/wiki/Hibernate-example \"Hibernate-example\"\n\n\n## Similar projects\n\nHere is a list of awesome projects that uses geohash:\n\n * [geohash-java](https://github.com/kungfoo/geohash-java) Another implementation of Geohashes in pure Java.\n * [geo](https://github.com/davidmoten/geo) Geohash utitlies in java \n \n## Blogs\n\n * [Designing a Spacial Index](https://dzone.com/articles/designing-spacial-index)\n \n## Useful links\n\n* [geohash.org browser](http://geohash.org/)\n* [alternative geohash browser](https://www.movable-type.co.uk/scripts/geohash.html)\n \n## Change log\n\nThe changelog is moved in its own file. It can be found on following [page](https://github.com/astrapi69/jgeohash/blob/develop/CHANGELOG.md)\n\n## Credits\n\n|**Travis CI**|\n|     :---:      |\n|![Travis CI](https://travis-ci.com/images/logos/TravisCI-Full-Color.png) \u003cimg width=500/\u003e|\n|[![build status](https://travis-ci.com/astrapi69/jgeohash.svg?branch=master)](https://travis-ci.com/astrapi69/jgeohash) |\n|Special thanks to [Travis CI](https://travis-ci.com) for providing a free continuous integration service for open source projects|\n|     \u003cimg width=1000/\u003e     |\n\n|**Nexus Sonatype repositories**|\n|     :---:      |\n|[![sonatype repository](https://img.shields.io/nexus/r/https/oss.sonatype.org/de.alpharogroup/jgeohash-core.svg?style=for-the-badge)](https://oss.sonatype.org/index.html#nexus-search;gav~de.alpharogroup~jgeohash-core~~~) jgeohash-core|\n|[![sonatype repository](https://img.shields.io/nexus/r/https/oss.sonatype.org/de.alpharogroup/jgeohash-geoip.svg?style=for-the-badge)](https://oss.sonatype.org/index.html#nexus-search;gav~de.alpharogroup~jgeohash-geoip~~~) jgeohash-geoip|\n|Special thanks to [sonatype repository](https://www.sonatype.com) for providing a free maven repository service for open source projects|\n|     \u003cimg width=1000/\u003e     |\n\n|**coveralls.io**|\n|     :---:      |\n|[![Coverage Status](https://coveralls.io/repos/github/astrapi69/jgeohash/badge.svg?branch=develop)](https://coveralls.io/github/astrapi69/jgeohash?branch=master)|\n|Special thanks to [coveralls.io](https://coveralls.io) for providing a free code coverage for open source projects|\n|     \u003cimg width=1000/\u003e     |\n\n|**javadoc.io**|\n|     :---:      |\n|[![Javadoc](http://www.javadoc.io/badge/de.alpharogroup/jgeohash-core.svg)](http://www.javadoc.io/doc/de.alpharogroup/jgeohash-core) jgeohash-core|\n|[![Javadoc](http://www.javadoc.io/badge/de.alpharogroup/jgeohash-geoip.svg)](http://www.javadoc.io/doc/de.alpharogroup/jgeohash-geoip) jgeohash-geoip|\n|Special thanks to [javadoc.io](http://www.javadoc.io) for providing a free javadoc documentation for open source projects|\n|     \u003cimg width=1000/\u003e     |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrapi69%2Fjgeohash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fastrapi69%2Fjgeohash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrapi69%2Fjgeohash/lists"}