JSPoint

API for creating and modifying Point objects.

Create a API with Module.createPoint.

var object = Module.createPoint("ID");

Function

getAltitude() → number

Returns the altitude of the object.

Information

• Return

  • number: Object's altitude (in meters).

Template

var dAltitude = point.getAltitude();

getFontColor() → JSColor

Returns the text color of the object.

Information

• Return

  • (JSColor): Successfully returns the text color.

  • null: text color return failed.

Template

var fontColor = object.getFontColor();

getFontName() → string

Returns the font name of the object's text.

Information

• Return

  • string: Successfully returns the text font name.

  • null: Font name return failed.

Template

var fontName = object.getFontName();

getFontOutColor() → JSColor

Returns the text outline color of the object.

Information

• Return

  • (JSColor): Successfully returns the text outline color.

  • null: Text outline return failed.

Template

var fontOutLineColor = object.getFontOutColor();

getFontSize() → number

Returns the text size of the object.

Information

• Return

  • number (0 or higher): Successfully returns the object's text size.

  • number (-1): If the object is null.

Template

var fontSize = object.getFontSize();

getFontWeight() → number

Returns the text weight of the object.

Information

• Return

  • number (0 or higher): Successfully returns the object's text weight.

  • number (-1): If the object is null.

Template

var fotnWeight = object.getFontWeight();

getHighlightIcon() → JSIcon

Returns the Highlight type icon object.

Information

• Return

  • JSIcon: The set icon object.

Template

var icon_hg = object.getHighlightIcon();

getIcon() → JSIcon

Returns the default type icon object.

Information

• Return

  • JSIcon: The set icon object.

Template

var icon_normal = object.getIcon();

getId() → string

Returns the ID of the object.

Information

• Return

  • string: Successful return of the object's Key string.

  • null: If the object is null.

Template

lat strKey = object.getId();

getLatitude() → number

Returns the latitude of the object.

Information

• Return

  • number: Object's latitude (in degrees).

Template

var dLatitude = point.getLatitude();

getLongitude() → number

Returns the longitude of the object.

Information

• Return

  • number: Object's longitude (in degrees).

Template

var dLongitude = point.getLongitude();

getPosition() → JSVector3D

Returns the position of the object.

Information

• Return

  • JSVector3D: Returns the bottom center coordinates (longitude, latitude, altitude) of the object successfully.

  • null: Coordinate return failed.

Template

var vPos = point.getPosition();

getVisibleRangeActivate() → boolean

Returns whether the visibility range value of the POI object is enabled or disabled.

If the visibility range value is disabled, the POI object's visibility range references the visibility range value of the layer to which the POI object belongs.

POI objects created through the service layer cannot have their visibility range values set.

Information

• Return

  • true: Visibility range setting successful.

  • false: Visible range setting failed.

  • Failure conditions.

    • If the POI object is created from data loaded from an external server.

    • If the POI object is null.

Template

var bActive = object.getVisibleRangeActivate();

getVisibleRangeMax() → number

Returns the maximum visibility range value of the POI object.

Information

• Return

  • Valid number: Successfully returns the maximum visibility range value.

  • In the following cases, the API always returns a fixed value.

    • -999.0: If the POI object is null.

    • -998.0: If the POI object is created from data loaded from an external server.

    • -997.0: If the visibility range setting is deactivated.

Template

var rangeMax = object.getVisibleRangeMax();

getVisibleRangeMin() → number

Returns the minimum visibility range value of the POI object.

Information

• Return

  • Valid number: Successfully returns the minimum visibility range value.

  • In the following cases, the API always returns a fixed value.

    • -999.0: If the POI object is null.

    • -998.0: If the POI object is created from data loaded from an external server.

    • -997.0: If the visibility range setting is deactivated.

Template

var rangeMin = object.getVisibleRangeMin();

isExistHighlightIcon() → boolean

Returns whether a highlight type icon is specified.

Information

• Return

  • true: An icon is specified.

  • false: No icon is specified.

Template

var bExistHighlightIcon = object.isExistHighlightIcon();

isExistIcon() → boolean

Returns whether a default type icon is specified.

Information

• Return

  • true: An icon is specified.

  • false: No icon is specified.

Template

var bExistNormalIcon = object.isExistIcon();

setAltitude(alt) → boolean

Sets the altitude value of the object (object latitude and longitude remain unchanged).

Information

Name	Type	Description
alt	number	Altitude (in meters).

• Return

  • true: Location setting successful.

  • false: Location setting failed.

Template

point.setAltitude(50.0);

setFontStyle(name, size, weight, fill_color, outline_color) → boolean

Sets the text style of the POI.

Font, size, weight, and color settings.

Information

Name	Type	Description
name	string	Font name
size	number	Text size
weight	number	Text weight
fill_color	JSColor	Text color
outline_color	JSColor	Text outline color

• Return

  • true: Object setting successful.

  • false: Object setting failed.

• Sample

  • Refer to function createPoint.

  • Sandbox_Path Analysis

Template

setHighlightIcon(icon) → boolean

Sets the Highlight type icon.

Information

Name	Type	Description
icon	JSIcon	image icon.

• Return

  • true: Icon setting successful.

  • false: If the object does not exist or the texture does not exist.

Template

var icon_hg = Module.getSymbol().getIcon("Icon_hg");
object.setHighlightIcon(icon_hg);

setIcon(icon) → boolean

Sets the default type icon.

Information

Name	Type	Description
icon	JSIcon	The icon object to set.

• Return

  • true: Icon setting successful.

  • false: If the object does not exist or the texture does not exist.

Template

var icon = Module.getSymbol().getIcon("Icon2");
object.setIcon(icon);

setImage(data, width, height) → boolean

Sets an image for the POI.

The data variable is based on a Uint8Array of binary array data.

Actual size of width, height must be entered (>1).

Information

Name	Type	Description
data	array	Image pixel value array.
width	number	Image width.
height	number	Image height.

• Return

  • true: image setting successful.

  • false: image setting failed.

  • Failure conditions.

    • If data value is null.

    • If width, height < 0

• Sample

  • Refer to function createPOI.

  • Sandbox_POI

Template

setLatitude(lat) → boolean

Sets the latitude value of the object (object longitude and altitude remain unchanged).

Information

Name	Type	Description
lat	number	Latitude (in degrees).

• Return

  • true: Location setting successful.

  • false: If the object does not exist.

Template

point.setLatitude(35.1713096);

setLongitude(lon) → boolean

Sets the longitude value of the object (object latitude and altitude remain unchanged).

Information

Name	Type	Description
lon	number	Longitude (in degrees).

• Return

  • true: Location setting successful.

  • false: If the object does not exist.

Template

point.setLongitude(129.1270931);

setLonLat(lon, lat) → boolean

Sets the location (longitude, latitude) of the object (object altitude remains unchanged).

Information

Name	Type	Description
lon	number	Longitude (in degrees).
lat	number	Latitude (in degrees).

• Return

  • true: Location setting successful.

  • false: Location setting failed.

Template

point.setLonLat(129.1270931, 35.1713096);

setPosition(position) → boolean

Sets the location of the POI.

Information

Name	Type	Description
position	JSVector3D	POI location coordinates (longitude, latitude, altitude).

• Return

  • true: Setting successful.

  • false: Setting failed.

• Sample

  • Refer to function createPOI.

  • Sandbox_POI

Template

setPositionLine(length, color) → boolean

Sets a line perpendicular to the ground to be visible for the specified length.

A length input value > 0 is required.

Information

Name	Type	Description
length	number	POI vertical line length.
color	JSColor	Color of the POI vertical line.

• Return

  • true: Object setting successful.

  • false: Object setting failed.

  • Failure conditions.

    • If type<0 value is set.

• Sample

  • Refer to function createPOI.

  • Sandbox_POI Line

Template

setRenderToTerrainTexture(type) → boolean

Sets the POI to be drawn on the terrain based on RTT.

Information

Name	Type	Description
type	boolean	true for terrain-combined visualization (RTT) false for default visualization.

• Return

  • true: Object setting successful.

  • false: Object setting failed.

• Sample

  • Refer to function createPOI.

  • Sandbox_POI RTT

Template

setText(text) → boolean

Sets the visualization text for the POI.

Information

Name	Type	Description
text	string	POI text

• Return

  • true: Object setting successful.

  • false: Object setting failed.

• Sample

  • Refer to function createPOI.

  • Sandbox_POI

Template

setVisibleRange(enable, min, max) → boolean

Sets the visibility range of the POI object.

If the min value is greater than the max, it automatically switches the smaller value to min and the larger value to max.

If the POI object is created from data loaded from an external server, the visibility range cannot be set.

Information

Name	Type	Description
enable	boolean	Whether to activate the visibility range value.
min	number	Minimum visibility distance.
max	number	Maximum visibility distance.

• Return

  • true: Visibility range setting successful.

  • false: Visibility range setting failed.

  • Failure conditions.

    • In the following cases, the API always returns false.

    • If the POI object is created from data loaded from an external server.

    • If the POI object is null.

Template

object.setVisibleRange(true, 50.0, 20000.0);

Getter / Setter

getDescription(), setDescription(desc) → string

Set a description for the object.

Information

Name	Type	Description
desc	string	Object description string.

• Return

  • string: Successful return of the object's description string.

  • null: If the object is null.

Template

var strDesc = object.getDescription();
// ... or ...
object.setDescription("First Object.");

getHighlight(), setHighlight(highlight) → boolean

Sets whether to use the Highlight type icon.

Information

Name	Type	Description
highlight	boolean	true: Sets to display the Highlight icon image. false: Sets to display the default icon image.

• Return

  • true: Setting successful.

  • false: Setting failed.

  • Failure conditions.

    • In the following cases, the API always returns false.

    • If the POI object is null.

    • If there is no icon set for the Highlight type.

Template

var bHighlightUsed = object.getHighlight();
// ... or ...
object.setHighlight(true);

getName(), setName(name) → string

Sets the name of the object.

Information

Name	Type	Description
name	string	The name to set for the object.

• Return

  • string: Successful return of the object's name.

  • null: If the object is null.

Template

var objName = object.getName();
// ... or ...
object.setName("MyObject");

getVisible(), setVisible(visible) → boolean

Sets the visibility state of an object.

Information

Name	Type	Description
visible	boolean	true: Make the object visible. false: Hide the object.

• Return

  • true: Object visible state.

  • false: Object hidden state.

Template

var objName = object.getName();
// ... or ...
object.setVisible(true);