From 0d87adff693e140e3314feff2a4e51b7c4174ebc Mon Sep 17 00:00:00 2001 From: Fr0sT-Brutal Date: Mon, 31 Oct 2022 15:09:17 +0300 Subject: [PATCH] v.0.9.3 --- CHANGELOG.md | 11 +++++++++++ README.md | 13 ++++++++++--- 2 files changed, 21 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 62099a0..52ecc16 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,14 @@ +0.9.3 +===== + +- Tile URL is now defined with OpenLayers-compatible templates with extended features + +`Added` + +- OSM.TilesProvider.pas, `FormatTileURL` function +* OSM.TilesProvider.*.pas, use new template-base system for retrieval of tile URL +- OpenTopoMap tile provider + 0.9.2 ===== diff --git a/README.md b/README.md index 25d9976..834368b 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ OSM MapControl ============== -Delphi/Lazarus visual component for displaying a map. Could use any map tile provider (currently implemented OpenStreetMap, HERE, Google). Also includes helper classes for storing and downloading map tiles. +Delphi/Lazarus visual component for displaying a map. Could use any map tile provider (currently implemented OpenStreetMap, OpenTopoMap, HERE, Google). Also includes helper classes for storing and downloading map tiles. Demo project implements downloading map tiles from network. :exclamation: **Alpha version, interface could change** :exclamation: @@ -14,16 +14,23 @@ Tested on: - Delphi XE2 and 10.1, VCL, Windows - Lazarus 2.1.0 trunk & FPC 3.3.1 trunk, LCL, Windows / Linux +Tile providers +-------------- + +Adding a new tile provider is easy, just learn its API and take implemented providers as example. When you're done, create pull request and I'll happily merge it. + +For description of tile URL template placeholders refer to OSM.TilesProvider.FormatTileURL function (or [docs](https://fr0st-brutal.github.io/Delphi_OSMMap/docs/OSM.TilesProvider.html#FormatTileURL)) + Project structure ----------------- - - `OSM.SlippyMapUtils` - util functions, variables and types + - `OSM.SlippyMapUtils` - utility functions, variables and types - `OSM.TileStorage` - classes `TTileBitmapCache` implementing cache of map tiles organized as a queue and `TTileStorage` implementing disc storage of map tiles. - `OSM.NetworkRequest` - utils and classes for network requesting of map tiles. Class `TNetworkRequestQueue` implements threaded non-blocking queue of network requests. Unit doesn't contain any real network request engine. - `OSM.NetworkRequest.Synapse`, `OSM.NetworkRequest.WinInet`, `OSM.NetworkRequest.RTL` contain concrete implementations of network requesting routines - `OSM.MapControl` contains classes `TMapMark` and `TMapMarkList` for managing a set of map points and `TMapControl` itself - `OSM.TilesProvider` - base abstract class of map tile provider. - - `OSM.TilesProvider.OSM`, `OSM.TilesProvider.HERE`, `OSM.TilesProvider.Google` contain concrete implementations of map tile providers + - `OSM.TilesProvider.*` contain concrete implementations of map tile providers Full docs for all units listed above is available [here](https://fr0st-brutal.github.io/Delphi_OSMMap/)