Struct PackedTileId 

pub struct PackedTileId { /* private fields */ }

An NDS.Live Packed Tile ID.

Per the NDS.Live standard, tile IDs are signed 32-bit integers: levels 0-14 are positive, while level 15 values are negative (bit 31 is the sign bit). Internally the value is stored as a u32 so that bit operations need not deal with the sign bit; conversion to/from signed happens only at the API boundary (see PackedTileId::value and PackedTileId::new).

Implementations

impl PackedTileId

pub fn new(value: i32) -> Result<Self, TileIdError>

Construct a PackedTileId from a signed i32 tile ID value.

Accepts the signed representation (negative for level 15). For a constructor that also accepts the unsigned representation or out-of-range values, see PackedTileId::from_i64.

pub fn from_value(value: i32) -> Result<Self, TileIdError>

Construct a PackedTileId from the signed NDS.Live public value.

pub fn from_i64(value: i64) -> Result<Self, TileIdError>

Construct a PackedTileId from an i64, accepting both signed and unsigned 32-bit representations (matching the Python constructor).

Negative values are interpreted as signed i32 and converted to the unsigned internal representation; values >= 2^32 are masked to 32 bits.

pub fn value(&self) -> i32

Get the tile ID value as a signed i32, per the NDS.Live standard.

Level 15 tiles return negative values; levels 0-14 return positive values.

pub fn from_tile_index( morton_number: u32, level: u32, ) -> Result<Self, TileIdError>

Create a PackedTileId directly from a tile morton number and level, without any coordinate conversion.

morton_number must be in 0..=2^(2*level+1) - 1.

pub fn from_tile_xy(x: u32, y: u32, level: u32) -> Result<Self, TileIdError>

Create a PackedTileId from tile-grid coordinates at the given level.

X is in 0..=2^(level+1)-1, Y is in 0..=2^level-1. Coordinates use the NDS Morton tile-grid order and are inverse to PackedTileId::x and PackedTileId::y.

pub fn from_nds_coordinates( x: i32, y: i32, level: u32, ) -> Result<Self, TileIdError>

Create the tile at level that contains the given NDS coordinate.

pub fn from_wgs84( longitude: f64, latitude: f64, level: u32, ) -> Result<Self, TileIdError>

Create the tile at level that contains the given WGS84 coordinate.

pub fn from_morton_and_level( morton_code: MortonCode, level: u32, ) -> Result<Self, TileIdError>

Create a PackedTileId for the tile at level that contains the full-precision NDS coordinates encoded in morton_code.

Note: the resulting tile’s PackedTileId::morton_number generally differs from morton_code.value().

pub fn level(&self) -> u32

Level of the tile (0..=15).

pub fn size(&self) -> i64

Size of the tile in NDS coordinate units (1 << (31 - level)).

pub fn dimensions_in_meters(&self) -> (f64, f64)

Tile dimensions in meters at the tile’s center latitude.

Returns (width_meters, height_meters).

pub fn center(&self) -> (i64, i64)

Center of the tile in NDS coordinates (x, y).

pub fn wgs84_from_nds_coordinates(x: i64, y: i64) -> (f64, f64)

Convert NDS integer coordinates to lon/lat degrees without edge normalization.

pub fn center_wgs84(&self) -> (f64, f64)

Center of the tile in lon/lat degrees.

pub fn south_west_wgs84(&self) -> (f64, f64)

South-west tile corner in lon/lat degrees.

pub fn north_east_wgs84(&self) -> (f64, f64)

Exclusive north-east tile corner in lon/lat degrees.

pub fn wgs84_size(&self) -> (f64, f64)

Tile width/height in lon/lat degrees.

pub fn south_west_corner(&self) -> (i64, i64)

South-west corner of the tile in NDS coordinates (x, y).

pub fn north_east_corner(&self) -> (i64, i64)

North-east corner of the tile in NDS coordinates (x, y).

This boundary is exclusive — it is the first point outside the tile.

pub fn morton_number(&self) -> u32

Morton number of the tile (the packed value minus the level offset).

pub fn x(&self) -> u32

Tile-grid X coordinate at this tile’s level.

pub fn y(&self) -> u32

Tile-grid Y coordinate at this tile’s level.

pub fn neighbour(&self, offset_x: i32, offset_y: i32) -> PackedTileId

Same-level tile at a relative grid offset, wrapping at the respective limits.

pub fn west_neighbour(&self) -> PackedTileId

Tile to the west at the same level (wraps at the antimeridian).

pub fn east_neighbour(&self) -> PackedTileId

Tile to the east at the same level (wraps at the antimeridian).

pub fn south_neighbour(&self) -> PackedTileId

Tile to the south at the same level (wraps at the south pole).

pub fn north_neighbour(&self) -> PackedTileId

Tile to the north at the same level (wraps at the north pole).

Trait Implementations

impl Clone for PackedTileId

fn clone(&self) -> PackedTileId

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for PackedTileId

impl Debug for PackedTileId

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for PackedTileId

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for PackedTileId

impl Hash for PackedTileId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for PackedTileId

fn cmp(&self, other: &PackedTileId) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for PackedTileId

fn eq(&self, other: &PackedTileId) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for PackedTileId

fn partial_cmp(&self, other: &PackedTileId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for PackedTileId