kmlb

KO | EN

gitlite — search

#javascript #react #ai #typescript #golang #android #rust #linux #docker #windows #cli #vue #ios #open-source

(★ 9)

Python Google Earth KML Builder

kmlb Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1>Plain Python KML Builder</h1>

A straightforward Google&nbsp;Earth KML builder for Python.

<a href="https://kmlb.dev/">kmlb.dev</a> &nbsp;&bull;&nbsp;
 <a href="https://kmlb.dev/docs/tutorial/">Tutorial</a> &nbsp;&bull;&nbsp;
 <a href="https://pypi.org/project/kmlb/">PyPI</a>

</div>

---

**Build KMLs in plain Python.**

KMLB is a dependency-free Python library for writing Google Earth KML files. Easily create points, lines, polygons, styles, and folders.

Name a style, point a feature at it, write the file:

```python
import kmlb

style = kmlb.point_style("city", color="red", icon="triangle")
boston = kmlb.point([-71.0589, 42.3601], "Boston", style_to_use="city")

kmlb.kml("My Places", [boston], styles=[style], path="my_places.kml")
```

Open `my_places.kml` in Google Earth and there is your map. No XML, no dependencies.

```bash
pip install kmlb
```

Building footprints extruded into 3D and viewed in Google Earth, built with KMLB polygons.

## The whole library

- **Features:** `point`, `search_poi`, `street_view`, `line`, `polygon`, grouped in `folder`s, written out with `kml`.
- **Easy styling:** `color="red"`, `icon="triangle"`. Skip the style and a feature still looks good.
- **3D:** altitude modes, ground extrusion, and `look_at` camera angles.
- **Geodesy:** `distance` and `bearing` between points, `destination` to offset a point by a bearing and distance (e.g. to draw radial lines and shapes).
- **Shapes:** 2D shapes (`circle`, `ellipse`, `rectangle`, `ngon`, `annulus`, `arc`, `wedge`, `ribbon`, `con_rings`, `fishnet`, `hex_grid`, `hex_field`), 3D solids (`cylinder`, `cone`, `dome`, `sphere`, `cube`, `pyramid`, `soccer_ball`), and `fresnel_zone` (RF link), all under `kmlb.shapes`.
- **And more:** `networklink_kml` for files that refresh from a URL.

Python 3.9+, standard library only.

3D solids (cylinder, cone, dome, sphere) placed over Boston, built with <code>kmlb.shapes</code>.

## Example use

### Writing a basic KML file

```python
import kmlb

# CREATE A POINT
fountain = kmlb.point([-71.051904, 42.358988, 0], "Rings Fountain")

# WRITE KML FILE
kmlb.kml(
    "Boston Fountain",          # KML name
    [fountain],                 # Features
    path="folder/boston_fountain.kml"  # Export path
)
```

### Mapping a POI or an address

```python
import kmlb

# CREATE A POINT FROM A POI
bos_common = kmlb.search_poi("Boston Common, Boston, MA")

# CREATE A POINT FROM AN ADDRESS
ss = kmlb.search_poi("700 Atlantic Avenue, Boston, MA", name="South Station")

# WRITE KML FILE
kmlb.kml(
    "Boston Landmarks",          # KML name
    [bos_common, ss],            # Features
    path="folder/boston_landmarks.kml"  # Export path
)
```

### Creating a customized KML file

```python
import kmlb

# DEFINE A STYLE
pt_style = kmlb.point_style(
    "Red Triangle",                # Point style name
    icon="triangle",               # Icon (built-in shorthand)
    color=("#ff0000", 100),        # Icon color (hex, opacity)
    scale=1.0,                     # Icon scale
    label_color=("#ffffff", 100),  # Label color (hex, opacity)
    label_size=1.0,                # Label size
)

# CREATE A POINT
clock_tower = kmlb.point(
    [-71.053568, 42.359053, 151],                   # Coordinates
    "Custom House Tower",                           # Name
    headers=["City", "Building", "Height (M)"],     # Attribute titles
    attrs=["Boston", "Custom House Tower", "151"],  # Attributes
    z_mode="RTG",                                   # Relative To Ground
    style_to_use="Red Triangle",                    # Name of point style defined earlier
)

# WRITE KML FILE
kmlb.kml(
    "Boston Clock Tower",                     # KML name
    [clock_tower],                            # Features to include
    path="folder/boston_clock_tower.kml",     # Export path
    desc="Created with KMLB Python Package",  # KML description
    styles=[pt_style],                        # Styles to include
)
```

## Functions

| Function | What it does |
|---|---|
| **Features** | |
| `point` | Point placemark from a `[lon, lat]` (or `[lon, lat, elev]`) coordinate. |
| `search_poi` | Placemark located by an address or search string, geocoded by Google Earth. |
| `street_view` | Point placemark built from a Google Maps Street View URL that opens that panorama. |
| `line` | Line or polyline from an ordered list of coordinates. |
| `polygon` | Polygon from one or more rings (first ring outer, the rest holes). |
| **Styles** | |
| `point_style` | Reusable point style: icon, color, scale, and label. |
| `line_style` | Reusable line style: color and width. |
| `polygon_style` | Reusable polygon style: fill and outline. |
| **Geodesy (WGS-84)** | |
| `distance` | Distance in meters between two coordinates. |
| `bearing` | Initial bearing in degrees between two coordinates. |
| `destination` | Coordinate reached from an origin along a bearing and distance. |
| **Shapes** | |
| `shapes.circle` | Circle polygon of a given radius around a point. |
| `shapes.ellipse` | Ellipse polygon from two semi-axes and an orientation. |
| `shapes.rectangle` | Rectangle polygon anchored at an upper-left corner, rotatable by azimuth. |
| `shapes.ngon` | Regular polygon (triangle, pentagon, hexagon, ...) around a point. |
| `shapes.annulus` | Filled ring polygon (an outer circle with a hole). |
| `shapes.arc` | Range-of-reach arc drawn as a line. |
| `shapes.wedge` | Pie-wedge (circular sector) polygon, useful for cellular coverage sectors. |
| `shapes.ribbon` | Buffered polygon around a path; even or per-point width. |
| `shapes.con_rings` | Folder of range-ring outlines from a list or a start/interval/count series. |
| `shapes.fishnet` | Folder of rectangular grid cells from a corner; clickable, ID-able. |
| `shapes.hex_grid` | Folder of tessellated hexagonal grid cells from a corner. |
| `shapes.hex_field` | Folder of hexagonal cells in a hexagon-shaped cluster of rings around a center; cells numbered outward from the center. |
| `shapes.fresnel_zone` | 3D Fresnel-zone tube plus line-of-sight path for a point-to-point radio link. |
| `shapes.cylinder` | 3D cylinder volume (or a frustum via `top_radius`); orientable along any axis. |
| `shapes.cone` | 3D cone; apex or base anchored, orientable along any axis. |
| `shapes.dome` | 3D hemisphere dome (or bowl when inverted). |
| `shapes.sphere` | 3D sphere; anchor by center or a pole. |
| `shapes.cube` | 3D cube or rectangular box. |
| `shapes.pyramid` | 3D pyramid with an n-sided base. |
| `shapes.soccer_ball` | 3D truncated icosahedron, two-tone. |
| **Views, documents, and links** | |
| `look_at` | Camera angle and view for a feature or document. |
| `camera` | Camera viewpoint (eye position and aim) for a feature or document. |
| `folder` | Group features and other folders together. |
| `kml` | Assemble features and styles into a KML document and write it to disk. |
| `networklink_kml` | Network-link KML that refreshes from a hosted URL. |
| **Color and icon helpers** | |
| `colors` | Named color palette (`colors.RED`, or `color="red"`). |
| `icons` | Built-in marker shorthands (`icon="triangle"`, `"red-paddle"`). |

A Fresnel-zone link tube and antenna coverage wedges, built with <code>kmlb.shapes</code>.

## Docs

Full reference and a step-by-step Boston tutorial at **[kmlb.dev](https://kmlb.dev/)**.

## Citing KMLB

Using KMLB in research or published work? Citing is never required, but it's
always appreciated. Even a quick mention helps others discover KMLB and shows
where it's making a difference. APA, Chicago, and BibTeX formats, kept current
with each release, are at **[kmlb.dev/docs/cite](https://kmlb.dev/docs/cite/)**.

```bibtex
@software{KMLB,
  author  = {Mros, III, Henry F.},
  title   = {KMLB: KML Builder},
  year    = {2026},
  version = {0.4.0},
  url     = {https://pypi.org/project/kmlb/}
}
```

## License

[MIT](pypi_package/LICENSE). Use it anywhere, including commercial work, as long as the
license notice stays.

kmlb

kmlb Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

kmlb

kmlb Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README