Crate staticmap

StaticMap is a library for rendering images of tile based maps.

StaticMap uses a builder pattern for building maps, lines and markers.

To get started, build a map instance using StaticMapBuilder and find the tool builders in the tools module.

Features:

• Render a map to a PNG image.
• Draw features on a map, such as:
  • Lines
  • Circles
  • PNG icons

Example

use staticmap::{
    tools::{Color, LineBuilder},
    StaticMapBuilder, Error,
};

fn main() -> Result<(), Error> {
    let mut map = StaticMapBuilder::default()
        .width(300)
        .height(400)
        .padding((10, 0))
        .build()?;

    let lat: &[f64] = &[52.5, 48.9];
    let lon: Vec<f64> = vec![13.4, 2.3];

    let red = Color::new(true, 255, 0, 0, 255);

    let line = LineBuilder::default()
        .lat_coordinates(lat.to_vec())
        .lon_coordinates(lon)
        .width(3.)
        .simplify(true)
        .color(red)
        .build()?;

    map.add_tool(line);
    map.save_png("line.png")?;

    Ok(())
}

Modules

• tools
  Tools for drawing features onto the map.

Structs

• Bounds
  Helper struct for converting to pixels, and to pass information about map bounds to implementors of Tool.
• StaticMap
  Main type. Use StaticMapBuilder as an entrypoint.
• StaticMapBuilder
  Builder for StaticMap.

Enums

• Error
  An enum containing all possible errors when interacting with this library.

Functions

• lat_to_y
  Latitude to y coordinate.
• lon_to_x
  Longitude to x coordinate.
• x_to_lon
  X to longitude coordinate.
• y_to_lat
  Y to latitude coordinate.