Skip to content

maps-as-data/tilelayer_finder

Repository files navigation

tilelayer_finder

tilelayer_finder is a small package for finding tilelayers/group layers available via the NLS tileserver and creating metadata.json files for them (for use in MapReader).

Installation

NOTE 02/05/2024: I've just removed the need to use poetry to run this, if you had previously installed with poetry you might need to re-install!

Pip install (use conda or other virtual env if you prefer)

git clone https://github.com/rwood-97/tilelayer_finder.git
cd tilelayer_finder
conda create -n tilelayer_finder python=3.11
conda activate tilelayer_finder
pip install .

Usage

CLI

usage: tlf_run [-h] [-c] [-ot TILES_OUTPUT] [-og GROUPS_OUTPUT] [-n [NAME ...]]

options:
  -h, --help            show this help message and exit
  -c, --clean           Whether to clean data
  -ot TILES_OUTPUT, --tiles-output TILES_OUTPUT
                        Name to use when saving output tilelayer file
  -og GROUPS_OUTPUT, --groups-output GROUPS_OUTPUT
                        Name to use when saving output group layer file
  -n [NAME ...], --name [NAME ...]
                        Name(s) of tilelayer(s)/group layer(s) to create metadata for

Interactive (notebooks)

See example.ipynb for usage example.

from tilelayer_finder import finder

tlf = finder.TileLayerFinder()
tlf.get_data(clean=True)
tlf.list_tilelayers()
tlf.list_group_layers()
tlf.save_data()
tlf.create_metadata_json("oneinch2nd")