https://github.com/andrerav/geohash.georaptor
A geohash compression library for efficiently reducing the size of large geohash collections.
https://github.com/andrerav/geohash.georaptor
Last synced: 8 months ago
JSON representation
A geohash compression library for efficiently reducing the size of large geohash collections.
- Host: GitHub
- URL: https://github.com/andrerav/geohash.georaptor
- Owner: andrerav
- License: mit
- Created: 2021-07-22T13:44:45.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2021-10-04T18:32:48.000Z (over 4 years ago)
- Last Synced: 2025-10-14T08:49:34.176Z (9 months ago)
- Language: C#
- Size: 75.2 KB
- Stars: 5
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Geohash.GeoRaptor: .NET Geohash Compression Tool 
_Note: This is a port of [ashwin711/georaptor](https://github.com/ashwin711/georaptor) to C#/.NET._
## Introduction
Geohash.GeoRaptor is a geohash compression library for efficiently reducing the size of large geohash collections. If you are wondering what geohashes are all about, I can recommend checking out [this website by Movable Type](https://www.movable-type.co.uk/scripts/geohash.html) which explains geohashing in simple terms while at the same time providing a highly visual technical demo.
## Download
| Package | Link | Description |
| ------- | ---- | ----------- |
| Geohash.GeoRaptor | [](https://www.nuget.org/packages/Geohash.GeoRaptor/) | Use this package to install GeoRaptor as a library in your C#/.NET project. |
| Geohash.GeoRaptor.CLI | [](https://www.nuget.org/packages/Geohash.GeoRaptor.CLI/) | Use this package to install GeoRaptor as a dotnet command line tool (see [CLI quickstart](#command-line-quickstart) below). You can install this tool using the command `dotnet tool install --global Geohash.GeoRaptor.CLI`. |
## API Quickstart
```csharp
var geohashes = new HashSet
{
"w21zf9", "w21zfc", "w21zg1",
"w21zg3", "w21zg9", "w21zgc2",
"w21zu1", "w21zu3", "w21zu9",
"w21zuc", "w21zv1", "w21zv3",
"w21zv9", "w21zvc", "w21zy1",
"w21zy3", "w21zy9", "w21zyc",
"w21xy8", "w21xyb", "w21xz0"
};
var result = GeoRaptor.Compress(geohashes, 4, 5);
// Outputs "w21zf, w21zg, w21zu, w21zv, w21zy, w21xy, w21xz"
Console.WriteLine(string.Join(", ", result.ToArray()));
```
## Command line quickstart
First install the [dotnet tool version](https://www.nuget.org/packages/Geohash.GeoRaptor.CLI/) of GeoRaptor:
```
dotnet tool install --global Geohash.GeoRaptor.CLI
```
Then execute the tool from the command line using the `georaptor` command:
```
georaptor --lowest-precision 3 --highest-precision 4 -f some_input_file.txt
```
You can also pipe data to the tool:
```
georaptor --lowest-precision 3 --highest-precision 4 < some_input_file.txt
```
The compressed output is simply printed to stdout.
Here is a complete list of available command line options:
```
-f, --input-file Path to a text file with geohashes (one geohash per line)
-l, --lowest-precision Required. Lowest precision
-h, --highest-precision Required. Highest precision
-g, --output-geometry Enable this to add WKB geometries to the output
--help Display this help screen.
--version Display version information.
```