jismeshcode 0.3.0

日本標準地域メッシュコード（JIS X 0410）を扱う包括的なRustライブラリ / A comprehensive Rust library for Japanese Standard Grid Square Code
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

#![cfg_attr(not(feature = "std"), no_std)]
#![cfg_attr(docsrs, feature(doc_auto_cfg))]
#![doc = include_str!("../README.md")]

//! # jismeshcode
//!
//! 日本標準地域メッシュコード（JIS X 0410）を扱うRustライブラリ
//!
//! ## 主な機能
//!
//! - 座標とメッシュコードの相互変換
//! - メッシュの階層操作（親子関係）
//! - 隣接メッシュの計算
//! - 空間範囲検索
//!
//! ## クイックスタート
//!
//! ```rust
//! use jismeshcode::prelude::*;
//!
//! // 座標からメッシュコードへ変換
//! let coord = Coordinate::new(35.6812, 139.7671).unwrap();
//! let mesh = coord_to_mesh(coord, MeshLevel::Third).unwrap();
//! println!("メッシュコード: {}", mesh);
//!
//! // メッシュの中心座標を取得
//! let center = mesh_to_center(mesh);
//! println!("中心座標: ({}, {})", center.lat(), center.lon());
//! ```

#[cfg(all(not(feature = "std"), not(feature = "libm")))]
compile_error!(
    "`no_std`環境では`libm`フィーチャーが必要です。\
     Cargo.tomlで `jismeshcode = { version = \"0.3\", default-features = false, features = [\"libm\"] }` を指定してください。"
);

extern crate alloc;

/// 座標とメッシュコードの変換機能
pub mod convert;
/// エラー型の定義
pub mod error;
/// メッシュの操作機能（階層、隣接など）
pub mod operations;
/// 空間検索機能
pub mod spatial;
/// 基本的な型定義
pub mod types;
/// ユーティリティ機能
pub mod utils;

/// よく使う型と関数を一括でインポートするためのprelude
pub mod prelude;

pub use convert::{coord_to_mesh, mesh_to_bounds, mesh_to_center};
pub use error::{CoordinateError, MeshCodeError, Result};
pub use operations::{bounds, center, children, contains, neighbor, neighbors, parent, to_level};
pub use spatial::{
    mesh_codes_in_bbox, mesh_codes_in_radius, mesh_codes_in_radius_from_mesh, MeshCodeIterator,
    MeshCodeRadiusIterator,
};
pub use types::{BoundingBox, Coordinate, Direction, MeshCode, MeshLevel};
pub use utils::distance::haversine_distance;