Tutorial: Import KML files into Altizure Planets

Now Altizure Planets can support importing kml file and plotting geometric annotations in batches. Entry into the Planets creation interface, click the Import Data icon from Toolbar, select KML button to import the kml file into the Planets and present it as a 3D solid.
Currently 4 types of brush geometries can be supported importing.

  • Annotation
  • Light Beam
  • Polyline
  • Polytube
  • Polygon

The feature file for corresponding point, line and polygon in kml is as below.
The KML data import process is roughly similar to SHP. Details refer to Tutorial: Import SHP Files into Altizure Planets.

File Type Correspondence

Planet Geometry Type KML Feature Category
Annotation Point
Lightbeam Point
Polyline Polyline
Polygon Polygon
Polytube Polyline

Notes to file import:

  • Please upload the .kml file;
  • The kml field name has a mapping relationship with the Planets attribute. Please refer to the corresponding relationship table below.

Demonstration Case

Now we have the map of the action trajectory in Guangzhou. The trajectory map contains point and line features, which is opened in QGIS as below. We want to import the label points and trajectories within KML into the planet.
广州市内行动轨迹图.png

Upload the KML data to Planets.

1572681525(1).png

When the upload is complete, you can configure the correspondence between KML data and the planet style properties.
This is the key step. Through field matching, you can set the style of the planet entity in batches by the original KML attribute, such as: color, transparency, label height, polyhedral height etc. (Details as per "Attribute Correspondence Table" below)
The fields with the same or similar names will be pre-assigned.
kml属性匹配.png

The imported KML data is syncing with the planet background:
导入的shp数据正在和星球后台同步.png

Import Outcome:
导入结果.png

Sample Data

Sample data access link: https://pan.baidu.com/s/1WAcaisxJCPlYkKMtQ6FmqQ
Password:jlaa

Attribute Correspondence Table

The type, height, style, and other information of geometric annotations on the planet can be controlled by setting and editing the corresponding field values in the kml file property sheet. If the fields are not defined, the Planet draws the annotation in the default style.

Annotations

Annotation corresponds to the point feature in kml file.

Field Name Data Format Corresponding Planet Label Attributes Required Remark
type Text(string) Type Yes marked as annotation
name Text(string) Name No e.g. new annotation
visible Integer Overall Visibility No 1 = Visible,0 = Hidden
icon Text(string) Label Icon No The English name of the icon - you can switch to the English version of the planet to see the corresponding English name of each icon.
textColor Text(string) Text Color No Text Color, e.g. #FFFFFF
pinLength Decimal number (real) Annotation Height No e.g. 23.60
textAlign Text(string) Text Position No center, left, right
descriptio Text(string) Introduction No

Lightbeam

Lightbeam corresponds to the point feature in kml file.

kml Field Name Data Format Corresponding Planet Label Attributes Required Remark
type Text(string) Type Yes marked as lightbeam
name Text(string) Name No e.g. new lightbeam
visible integer Overall Visibility No 1 = Visible,0 = Hidden
labelsVisi integer Label Visibility No 1 = Visible,0 = Hidden
textColor Text(string) Text Color No Text Color, e.g. #FFFFFF
color Text(string) Shape Color No Overall shape color,e.g.#FFFFFF
radius Decimal number (real) Radius No e.g. 5
height Decimal number (real) Height No 如 40
pinLength Decimal number (real) Ligtbeam Height No e.g. 23.60
opacity Decimal number (real) Transparency No 0~1 Floating Point
textAlign Text(string) Text Position No center, left, right
descriptio Text(string) Introduction No

Polyline

Polyline corresponds to the polyline feature in kml file.

kml Field Name Data Format Corresponding Planet Label Attributes Required Remark
type Text(string) Type Yes marked as polyline
name Text(string) Name No e.g. new polyline
visible integer Overall Visibility No 1 = Visible,0 = Hidden
labelsVisi integer Label Visibility No 1 = Visible,0 = Hidden
texture Text(string) Texture No e.g.fence, arrow
animation Text(string) Animation No Horizontal Flow:horizontal,Vertical Flow:vertical,None:none
icon Text(string) Label Icon No The English name of the icon - you can switch to the English version of the planet to see the corresponding English name of each icon.
textColor Text(string) Text Color No Text Color, e.g. #FFFFFF
color Text(string) Shape Color No Overall shape color,e.g.#FFFFFF
pinLength Decimal number (real) Polyline Height No e.g. 23.60
lineWidth Decimal number (real) Line Width No e.g. 0.60
fenceHeigh Decimal number (real) Fence Height No e.g. 7.60
opacity Decimal number (real) Transparency No 0~1 Floating Point
textAlign Text(string) Text Position No center, left, right
descriptio Text(string) Introduction No

Polygon

Polygon corresponds to the polygon feature in kml file.

kml Field Name Data Format Corresponding Planet Label Attributes Required Remark
type Text(string) Type Yes marked as polygon
name Text(string) Name No e.g. new volume
visible integer Overall Visibility No 1 = Visible,0 = Hidden
labelsVisi integer Label Visibility No 1 = Visible,0 = Hidden
textColor Text(string) Text Color No Text Color, e.g. #FFFFFF
color Text(string) Shape Color No Overall shape color,e.g.#FFFFFF
hasTopCove integer Top Visibility No 1 = Visible,0 = Hidden
hasBottomC integer Bottom Visibility No 1 = Visible,0 = Hidden
top Decimal number (real) Top Height No e.g. 40
bottom Decimal number (real) Bottom Height No e.g. 5
pinLength Decimal number (real) Polygon Height No e.g. 23.60
opacity Decimal number (real) Transparency No 0~1 Floating Point
descriptio Text(string) Introduction No

Polytube

Polytube corresponds to the polyline feature in kml file.

kml Field Name Data Format Corresponding Planet Label Attributes Required Remark
type Text(string) type Yes marked as polytube
name Text(string) Name No e.g. new tube
lineWidth Decimal number (real) Line Width No Set the pipe width in meters
texture Text(string) Texture No e.g.fence, arrow
animation Text(string) Animation No Horizontal Flow:horizontal,Vertical Flow:vertical,None:none
color Text(string) Shape Color No Overall shape color,e.g.#FFFFFF
visible integer Overall Visibility No 1 = Visible,0 = Hidden
labelsVisi integer Label Visibility No 1 = Visible,0 = Hidden
opacity Decimal number (real) Transparency No 0~1 Floating Point
icon Text(string) Label Icon No The English name of the icon - you can switch to the English version of the planet to see the corresponding English name of each icon.
textColor Text(string) Text Color No Text Color, e.g. #FFFFFF
pinLength Decimal number (real) Polytube Height No e.g. 23.60
textAlign Text(string) Text Position No center, left, right
descriptio Text(string) Introduction No