---
id: "kml_coordinates"
kind: "datatype"
status: "draft"
is_pii: false
name: "KML coordinate list"
regexp: "^\\s*-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?(?:,-?\\d+(?:\\.\\d+)?)?(?:\\s+-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?(?:,-?\\d+(?:\\.\\d+)?)?)+\\s*$"
categories: ["geo"]
langs: ["common"]
quality: 90
url: "https://registry.apicrafter.io/datatype/kml_coordinates"
---

# KML coordinate list (`kml_coordinates`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Coordinates of a KML geometry as the coordinates element of KML 2.2 (OGC 07-147r2) writes them: tuples of longitude, latitude and an optional altitude separated by commas, one tuple after another separated by whitespace, in WGS 84, as in -58.38,-34.60,0 -58.40,-34.61,0. KML-to-table exports keep the text of a ring or a line in one cell: the Ku and C band footprints of the ARSAT satellites on the ARSAT open data portal are CSV files with one polygon ring per row. The GML form, numbers separated by spaces only, is gml_poslist; a geometry in JSON is geojson.

- Personal data (PII): no
- Categories: Geographic identifiers (geo)
- Countries: global
- Languages: Common to most languages (common)

## Detection

Regular expression (Python `re`):

```
^\s*-?\d+(?:\.\d+)?,-?\d+(?:\.\d+)?(?:,-?\d+(?:\.\d+)?)?(?:\s+-?\d+(?:\.\d+)?,-?\d+(?:\.\d+)?(?:,-?\d+(?:\.\d+)?)?)+\s*$
```

## Examples

- `-68.96836853027344,-81.1478500366211,0.0 -72.55793762207031,-79.67288208007812,0.0 -73.5025863647461,-77.90192413330078,0.0` — start of a ring of the Ku band footprint of ARSAT-1 (ARSAT open data portal)
- `-3.7038,40.4168 -3.7040,40.4170` — a line of two positions without altitude
- `123629.78 379674.57 123700.0 379674.57` (invalid example) — numbers separated by spaces only: gml_poslist
- `220,220,220` (invalid example) — one tuple of integers: an RGB colour (rgbcolor)

## Metacrafter rules

1 rules: 0 match the field name, 1 match values.

- `kmlcoordinatestext` (data, `common/geo_text.yaml`)

## Supported by tools

- [`metacrafter`](https://registry.apicrafter.io/tool/metacrafter.md)

## Translations

- es: Lista de coordenadas KML

## Sources

- doc: <https://developers.google.com/kml/documentation/kmlreference#coordinates>
- doc: <https://www.ogc.org/standard/kml/>
- doc: <https://datos.arsat.com.ar/dataset/cobertura-satelite-arsat-1>

## Quality

Score 90/100. Missing: mapping (Wikidata, Schema.org, ...).

JSON: <https://registry.apicrafter.io/api/v1/datatypes/kml_coordinates.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/geo/kml_coordinates.yaml>
