Bland.Basemaps.Earth (Elixir Technical Drawing v0.2.0)

Copy Markdown View Source

Hand-curated, low-resolution Earth coastline, border, and reference line data.

All coordinates are {longitude_deg, latitude_deg}. Continental outlines are closed polygons (first point == last point) traced roughly clockwise. They have enough detail to be recognizable at world scale and not more — this is a schematic data set, not a cartographic one.

Summary

Functions

Returns the list of political border features at the requested resolution.

Returns the list of coastline features at the requested resolution.

Returns the standard reference parallels as open polylines spanning lon ∈ [-180, 180]. Useful as dashed or dotted overlay lines.

Types

feature()

@type feature() :: %{
  name: String.t(),
  points: [{float(), float()}],
  closed?: boolean()
}

Functions

borders(resolution \\ :low)

@spec borders(:low | :high | :schematic) :: [Bland.Basemaps.feature()]

Returns the list of political border features at the requested resolution.

  • :low — Natural Earth 1:110m (default). 177 sovereign polygons, ~10k points, ~180 KB compiled.
  • :high — Natural Earth 1:50m. ~240 polygons (including disputed areas), ~100k points, ~1.6 MB compiled.
  • :schematic — the 10 hand-curated national outlines shipped with BLAND 0.1.

coastlines(resolution \\ :low)

@spec coastlines(:low | :high | :schematic) :: [Bland.Basemaps.feature()]

Returns the list of coastline features at the requested resolution.

Resolutions

  • :low — Natural Earth 1:110m (default). ~130 features, ~5k points, ~90 KB compiled.
  • :high — Natural Earth 1:50m. ~1,400 features, ~60k points, ~1 MB compiled.
  • :schematic — the hand-curated continental outlines shipped with BLAND 0.1 (15 features). Useful when you want a deliberately rough, "drawn by a draftsman" look.

All three datasets share the same feature-map shape: %{name: String.t(), points: [{lon, lat}], closed?: bool}.

tropics()

@spec tropics() :: [Bland.Basemaps.feature()]

Returns the standard reference parallels as open polylines spanning lon ∈ [-180, 180]. Useful as dashed or dotted overlay lines.