# xt

**Repository Path**: mirrors_mapbox/xt

## Basic Information

- **Project Name**: xt
- **Description**: Automatically convert a stream of tile coordinates to another format
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-09
- **Last Updated**: 2026-01-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

xt
===

[![Build Status](https://app.travis-ci.com/mapbox/xt.svg?branch=master)](https://app.travis-ci.com/mapbox/xt) [![Coverage Status](https://coveralls.io/repos/github/mapbox/xt/badge.svg?branch=master)](https://coveralls.io/github/mapbox/xt?branch=master)

Automatically convert a stream of tile coordinates to another format

- `z/x/y | z-x-y` ==> `[x, y, z]`

- `[x, y, z]` ==> `z/x/y` | `z-x-y` | `z?x?y -d ?`


Installation
-------------
```
pip install xt
```
Or to develop:
```
git@github.com:mapbox/xt.git && cd xt && pip install -e '.[test]'
```

Examples
---------
Tile URL to [mercantile](https://github.com/mapbox/mercantile) `[x, y, z]`
```
» echo https://map.s/17/20971/5051.png | xt
[20971, 50651, 17]
```
mercantile to `z/x/y`
```
» echo '[0, 0, 0]' | xt
0/0/0
```
mercantile to `z-x-y`
```
» echo '[100, 100, 100]' | xt -d -
100-100-100
```
roundtripping
```
» pbpaste | xt | xt -d - | xt | xt | xt | xt -d | xt | xt 
17/20972/50653
```
Using mercantile to generate tile urls from a parent tile:
```
» echo '[0, 0, 0]' | mercantile children --depth 2 | xt | awk '{print "https://map.s/"$NF".png"}'
https://map.s/2/0/0.png
https://map.s/2/1/0.png
https://map.s/2/1/1.png
https://map.s/2/0/1.png
https://map.s/2/2/0.png
https://map.s/2/3/0.png
https://map.s/2/3/1.png
https://map.s/2/2/1.png
https://map.s/2/2/2.png
https://map.s/2/3/2.png
https://map.s/2/3/3.png
https://map.s/2/2/3.png
https://map.s/2/0/2.png
https://map.s/2/1/2.png
https://map.s/2/1/3.png
https://map.s/2/0/3.png
```