# Japan Geo Reverse Lookup
A Rust library for reverse geocoding in Japan. Given a longitude and latitude,
this library returns information about the region(s) the coordinates are located
in, including code, name, and English name.
## Installation
### Rust
```bash
cargo add reversejp
```
```rust
// reversejp-rust/examples/demo.rs
use reversejp::ReverseJp;
let reverse_jp = ReverseJp::with_embedded_data().unwrap();
let props = reverse_jp.find_properties(139.7670, 35.6812);
for prop in props {
println!("Code: {}, Name: {}, English Name: {}", prop.code, prop.name, prop.en_name);
}
```
Example output:
```text
Code: 130010, Name: 東京都, English Name: Tokyo
Code: 1310100, Name: 千代田区, English Name: Chiyoda City
```
Performance benchmark(Under MacBook Pro with Apple M3 Max):
### Python
```bash
pip install reversejp
```
```py
# reversejp-python/examples/demo.py
import reversejp
props = reversejp.find_properties(139.7670, 35.6812)
for prop in props:
print(prop.code, prop.name, prop.en_name)
```
Example output:
```text
130010 東京都 Tokyo
1310100 千代田区 Chiyoda City
```
Performance benchmark(Under MacBook Pro with Apple M3 Max):
```text
-------------------------------------------------- benchmark: 1 tests --------------------------------------------------
Name (time in us) Min Max Mean StdDev Median IQR Outliers OPS (Kops/s) Rounds Iterations
------------------------------------------------------------------------------------------------------------------------
test_city_benchmark 11.2909 623.2501 13.9494 20.8232 12.5421 0.5411 91;3468 71.6877 21090 1
------------------------------------------------------------------------------------------------------------------------
```
### WebAssembly
- [ ] add npm install.
```bash
make build
```
The command above produces a `pkg/` directory containing the WebAssembly module and TypeScript bindings that can be published to npm or consumed directly.
```js
import initWasm, { initialize, find_properties } from "reversejp-wasm";
await initWasm();
initialize();
const results = find_properties(139.767, 35.6812);
console.log(results);
```
`find_properties` returns an array of objects with the same shape as the `Properties` struct in the Rust crate: `{ code, name, enName }`.
## License
MIT
Data is sourced from the Japan Meteorological Agency website.