Skip to content

Latest commit

 

History

History
97 lines (80 loc) · 3.01 KB

README.md

File metadata and controls

97 lines (80 loc) · 3.01 KB
Raw

PHP MapTiler, Simple Map Tiles Generator

Simple Map Tiles Generator allow to make the Map Tiles using PHP. That allow to build simple custom map. Here not exist any geographical calculations, because I have no idea how to :) Just fork/pull it if you know how to make it better ;)

Requirements

  • PHP >= 5.3 version
  • PHP Imagic extension >= 3.0 version
  • A lot CPU time (for images with high resolution and for high zoom level)
  • A lot free disc space
  • Patience ;)

Usage example

Make custom map, based on my-image.jpg.

Generate the Tiles:

//init
$map_tiler = new MapTiler('/full/path/to/my-image.jpg', array(
  'tiles_path' => '/full/path/to/where-store-result/',
  'zoom_max' => 3,
  'format' => 'png',
  'tms' => false,
  'store_structure' => '%d/tile-%d-%d',
));
//execute
try {
  $map_tiler->process(true);
} catch (Exception $e) {
  echo $e->getMessage();
  echo $e->getTraceAsString();
}

Display the result using Leaflet.js

<html>
<head>
  <link rel="stylesheet" href="dist/leaflet.css" />
</head>
<body>
  <div id="map" style="width: 700px; height: 500px;"></div>
  <script src="dist/leaflet.js"></script>
  <script>

  var tiles = L.tileLayer('tiles-path/{z}/{x}/{y}.jpg', {
    minZoom: 0,
    maxZoom: 3,
    tms: true
  });

  var map = L.map('map', {
    center: [0, 0],
    zoom:1,
    minZoom: 0,
    maxZoom: 3,
    //crs: L.CRS.Simple, //available in dev version
    layers:[tiles]
  });
  </script>
</body>
</html>

API

Options

  • tile_size - the tile size (def: 256);
  • store_structure - the tile name, can contain / for split zoom, x , y by folder (def: '%d/%d/%d');
  • force - force create new tile if it already exist (def: false);
  • tms - use TMS tile addressing, which is used in open-source projects like OpenLayers or TileCache (def: true);
  • fill_color - color for fill free space if tile is not a square (def: 'white');
  • zoom_min - minimum zoom level for make tiles (def: 0);
  • zoom_max - maximum zoom level for make tiles (def: 8);
  • scaling_up - zoom level when scalling up still allowed, when the base image have less size than need for a curent zoom level (def: 0);
  • format - image fomat (def: jpeg);
  • quality_jpeg - quality for jpeg format (def: 80);
  • imagick_tmp - temp folder for ImageMagick, useful if system /tmp folder have not enough free space (def: null);

Publick Methods

  • __construct($image_path, $options = array()) - constructor
  • setOptions($options) - can be used for set/change options
  • getOptions() - return options array
  • process($clean_up = false) - run process for the tiles generation, set $clean_up=true to remove the base zoom images
  • prepareZoomBaseImages($min = null, $max = null) - prepare the base zoom images, $min - min zoom level, $max - max zoom level
  • removeZoomBaseImages($min = null, $max = null) - remove the base zoom images
  • tilesForZoom($zoom) - generate the tiles for given $zoom level

Attention

This script do NOT related to maptiler.com, that is stand alone project.