unvt / zfxy-spec

ZFXY specifications

zfxy-spec: ZFXY specifications

Definition

Three-dimentional spatial identifier candidate ZFXY of a point with longitude lng [decimal degrees], latitude lat [decimal degrees] (lat_rad in radians), and elevation h [m] shall be encoded {z}/{f}/{x}/{y} when a zoom level z is given as an integer and f, x, y are given in the following formulae:

• f = floor(n * h / H)
• x = floor(n * ((lng + 180) / 360))
• y = floor(n * (1 - log(tan(lat_rad) + (1 / cos(lat_rad))) / PI) / 2) where n = 2 ^ z, Z = 25 and H = 2 ^ Z [m].

Definitions of z, x, y are the same as ones in the industry standard Slippy Map Tilenames.

Characteristics

• Height of a voxel represented by a ZFXY with z=Z is 1 [m].

Future considerations

• More compact encodings of ZFXY may be considered in future.
• The value of Z is still subject to change.