Skip to content

map components ​

System map (iOS support only) ​

attributetypeDefault valueRequiredIntroductionsSupport Level
longitudenumber116.46yesCentral longitude✅
latitudenumber39.92yesCentral latitude✅
scalenumber16noZoom level, values range from 3-20✅
min-scalenumber3noMinimum Zoom Level✅
max-scalenumber20noMaximum zoom level✅
markersArray.markernoMarker point✅
polylineArray.polylinenoroute✅
circlesArray.circlenocircular✅
controlsArray.controlnoControl is about to be deprecated and recommended cover-view Substitute)❌
include-pointsArray.pointnoScale the field of view to include all the given coordinate points✅
show-locationbooleanfalsenoDisplays the current anchor point with direction✅
polygonsArray.polygonnopolygon✅
subkey-noPersonalized Map Configuration Style, does not support dynamic modification❌
layer-style-noPersonalized Map Configuration Style, does not support dynamic modification❌
rotatenumber0noAngle of rotation 0 360, Map due north and equipment and Angle of axis angle❌
skewnumber0noAngle, range 0 40 , about with Inclination angle of shaft❌
enable-3DbooleanfalsenoDisplay 3D block(Tools not supported)✅
show-compassbooleanfalsenoShow compass✅
show-scalebooleanfalsenoDisplay scale, tool does not support✅
enable-overlookingbooleanfalsenoOpen up Overlook❌
enable-zoombooleantruenoWhether scaling is supported✅
enable-scrollbooleantruenoDrag supported✅
enable-rotatebooleanfalsenoSupport for rotation✅
enable-satellitebooleanfalsenoWhether to turn on satellite imagery✅
enable-trafficbooleanfalsenoWhether to turn on real-time traffic✅
enable-poibooleantruenoWhether to show THEN poin✅
enable-buildingbooleannoWhether to display buildings✅
settingobjectnoConfiguration item✅
bindtapeventhandlenoTriggered when the map is clicked, Return latitude and longitude information❌
bindmarkertapeventhandlenoTriggered when the marker point is clicked, e.detail = {markerId}❌
bindlabeltapeventhandlenoTriggered when the label is clicked, e.detail = {markerId}❌
bindcontroltapeventhandlenoTriggered when the control is clicked, e.detail = {controlId}❌
bindcallouttapeventhandlenoWhen you click on the bubble corresponding to the marker point, e.detail = {markerId}❌
bindupdatedeventhandlenoTriggered when the map render update is complete❌
bindregionchangeeventhandlenoTriggered when visual field changes✅
bindpoitapeventhandlenoTriggered when the map poi point is clicked, e.detail = {name, longitude, latitude}❌
bindanchorpointtapeventhandlenoWhen the positioning mark is clicked, e.detail = {longitude, latitude}❌

marker ​

attributeIntroductionstypeRequiredRemarksSupport Level
idMarker point idnumbernomarker Click the event callback to return this id。✅
clusterIdAggregate cluster idnumbernoTo customize the point cluster effect✅
joinClusterParticipate in point aggregationBooleannoDefault does not participate in point aggregation❌
latitudelatitudenumberyesFloating point number, range -90 90✅
longitudelongitudenumberyesFloating point number, range -180 180✅
titleCalling-outstringnoShown when clicked, and ignored when callout exists✅
zIndexDisplay levelnumberno❌
iconPathDisplay iconsstringyesProject directory under the picture path, support network path, local path, code package path✅
rotateRotation anglenumbernoThe angle of a clockwise rotation 0 360, default to 0❌
alphaAnnotated transparencynumbernodefault 1, no transparency, scope 0 1❌
widthLabel icon widthnumber/stringnoLabel icon width❌
heightMark icon heightnumbernoDefault is the actual height of the picture❌
calloutBubble window above the marker pointObjectnoThe supported properties are shown in the following table and are recognized as newlines.✅
customCalloutCustom bubble windowobjectno❌
labelAdd labels next to marker pointsObjectnoThe supported properties are shown in the following table and are recognized as newlines.❌
anchorLatitude and longitude at anchor point of callout icon, default bottom midpointObjectnoLatitude and longitude at anchor point of callout icon, default bottom midpoint❌
aria-labelAccessibility, additional description of (attribute) elementsstringno❌

marker Bubbles on top callout ​

attributeIntroductionstypeRemarksSupport Level
contenttextstring✅
colorText colorstring❌
fontSizeText sizenumber❌
borderRadiusBorder filletnumber❌
borderWidthBorder widthstring❌
borderColorBorder colorstring❌
bgColorBackground colorstring❌
paddingText marginnumber❌
display'BYCLICK ': Click Show 'Always': Chang Hinstring❌
textAlign'BYCLICK ': Click Show 'Always': Chang Hinstring❌
anchorXLateral offset, positive to the rightnumber❌
anchorYVertical offset, positive downwardnumber❌

marker Custom bubbles on customCallout ​

The callout and title attributes are ignored when customCallout exists. The custom bubble adopts cover-view customization, which is more flexible.

attributeIntroductionstypeRemarksSupport Level
display'BYCLICK ': Click Show 'Always': Chang Hinstring❌
anchorXLateral offset, positive to the rightnumber❌
anchorYVertical offset, positive downwardnumber❌

The slot node named callout is added to the map component. Its internal cover-view is bound to the marker through the mark-id attribute. When the marker is created, the content displayed by the cover-view will be displayed as a callout above the marker point.

js
<map>
  <cover-view slot="callout">
    <cover-view marker-id="1"></cover-view>
    <cover-view marker-id="2"></cover-view>
    <cover-view marker-id="3"></cover-view>
  </cover-view>
</map>

marker Bubbles on top label ​

attributeIntroductionstypeRemarksSupport Level
contenttextstring✅
colorText colorstring❌
fontSizeText sizenumber❌
anchorXThe coordinates of the label, the origin is marker Corresponding latitude and longitudenumber❌
anchorYThe coordinates of the label, the origin is marker Corresponding latitude and longitudenumber❌
borderWidthBorder widthnumber❌
borderColorBorder colorstring❌
borderRadiusBorder filletnumber❌
paddingText marginnumber❌
textAlignText alignment. Valid value: left, right, centerstring❌

polyline ​

attributeIntroductionstypeRequiredRemarksSupport Level
pointsLongitude and latitude arrayarrayyes[{latitude: 0, longitude: 0}]✅
colorLongitude and latitude arraystringnoHexadecimal✅
colorListRainbow linearraynoIgnore when present color value❌
widthWidth of linenumberno✅
dottedLineWhether dashed linesbooleannodefault false❌
arrowLineLines with arrowsbooleannodefault false❌
arrowIconPathReplace Arrow Iconstringnoin arrowLine for true Effective❌
borderColorBorder color of linestringno❌
borderWidthThickness of linenumberno❌
levelGland relationstringnoDefault is abovelabels❌

polygon ​

attributeIntroductionstypeRequiredRemarksSupport Level
pointsLongitude and latitude arrayarrayyes[{latitude: 0, longitude: 0}]✅
strokeWidthLongitude and latitude arraynumberno✅
strokeColorStroke colorstringnoHexadecimal✅
fillColorStroke colorstringnoHexadecimal✅
zIndexSet polygon z-axis valuenumberno✅
levelGland relationstringnoDefault is abovelabels❌

circle ​

attributeIntroductionstypeRequiredRemarksSupport Level
latitudelatitudenumberyesFloating point number, range -90 90✅
longitudelongitudenumberyesFloating point number, range -180 180✅
colorStroke colorstringnoHexadecimal✅
fillColorFill colorstringnoHexadecimal✅
radiusRadiusnumberyes✅
strokeWidthRadiusnumberno✅
levelGland relationstringnoDefault is abovelabels❌

control ​

attributeIntroductionstypeRequiredRemarksSupport Level
idControl idnumbernoClicking on an event callback in a control returns this id❌
positionControl location on the mapobjectyesControl relative map position❌
iconPathDisplay iconsstringyesProject directory picture path, support local path, code package path❌
clickableIs it clickable?booleannoDefault not clickable❌

position ​

attributeIntroductionstypeRequiredRemarksSupport Level
leftHow far from the left edge of the map?numbernoDefaults to 0❌
topHow far to the upper boundary of the map?numbernoDefaults to 0❌
widthControl WidthnumbernoDefaults to 0❌
heightControl HeightnumbernoDefaults to 0❌

Gaode Map ​

attributetypeDefault valueRequiredIntroductionsSupport Level
longitudenumber116.46yesCentral longitudeiOS:✅ Android:✅ IDE:✅
latitudenumber39.92yesCentral latitudeiOS:✅ Android:✅ IDE:✅
scalenumber16noZoom level, values range from 3-20iOS:✅ Android:✅ IDE:✅
min-scalenumber3noMinimum Zoom LeveliOS:✅ Android:✅ IDE:✅ Dynamic change is not supported
max-scalenumber20noMaximum zoom leveliOS:✅ Android:✅ IDE:✅ Dynamic change is not supported
markersArray.markernoMarker pointiOS:✅ Android:✅ IDE:✅
polylineArray.polylinenorouteiOS:✅ Android:✅ IDE:✅
circlesArray.circlenocirculariOS:✅ Android:✅ IDE:✅
controlsArray.controlnoControl is about to be deprecated and recommended cover-view Substitute)iOS:❌ Android:❌ IDE:✅
include-pointsArray.pointnoScale the field of view to include all the given coordinate pointsiOS:✅ Android:✅ IDE:❌
show-locationbooleanfalsenoDisplays the current anchor point with directioniOS:✅ Android:✅ IDE:❌
polygonsArray.polygonnopolygoniOS:✅ Android:✅ IDE:✅
subkey-noKey to personalize map usageiOS:❌ Android:❌ IDE:❌
layer-style-noPersonalized Map Configuration Style, does not support dynamic modificationiOS:❌ Android:❌ IDE:❌
rotatenumber0noAngle of rotation 0 360, Map due north and equipment and Angle of axis angleiOS:✅ Android:✅ IDE:✅
skewnumber0noAngle, range 0 40 , about with Inclination angle of shaftiOS:✅ Android:✅ IDE:✅
enable-3DbooleanfalsenoDisplay 3D block(Tools not supported)iOS:❌ Android:❌ IDE:❌
show-compassbooleanfalsenoShow compassiOS:✅ Android:✅ IDE:❌
show-scalebooleanfalsenoDisplay scale, tool does not supportiOS:✅ Android:✅ IDE:✅
enable-overlookingbooleanfalsenoOpen up OverlookiOS:✅ Android:✅ IDE:❌
enable-zoombooleantruenoOpen up OverlookiOS:✅ Android:✅ IDE:✅
enable-scrollbooleantruenoDrag supportediOS:✅ Android:✅ IDE:✅
enable-rotatebooleanfalsenoSupport for rotationiOS:✅ Android:✅ IDE:✅
enable-satellitebooleanfalsenoWhether to turn on satellite imageryiOS:✅ Android:✅ IDE:✅
enable-trafficbooleanfalsenoWhether to turn on real-time trafficiOS:✅ Android:✅ IDE:✅
enable-poibooleantruenoWhether to show THEN pointiOS:✅ Android:✅ IDE:✅
enable-buildingbooleannoWhether to display buildingsiOS:✅ Android:✅ IDE:✅
settingobjectnoConfiguration itemiOS:✅ Android:✅ IDE:✅
bindtapeventhandlenoTriggered when the map is clicked, Return latitude and longitude informationiOS:✅ Android:✅ IDE:✅
bindmarkertapeventhandlenoTriggered when the map is clicked, Return latitude and longitude information from 2.9.0iOS:✅ Android:✅ IDE:✅
bindlabeltapeventhandlenoTriggered when the label is clicked, e.detail = {markerId}iOS:❌ Android:❌ IDE:❌
bindcontroltapeventhandlenoTriggered when the control is clicked, e.detail = {controlId}iOS:❌ Android:❌ IDE:✅
bindcallouttapeventhandlenoWhen you click on the bubble corresponding to the marker point, e.detail = {markerId}iOS:✅ Android:✅ IDE:❌
bindupdatedeventhandlenoTriggered when the map render update is completeiOS:✅ Triggered only when the map is loaded Android:✅ Triggered only when the map is loaded IDE:❌
bindregionchangeeventhandlenoTriggered when visual field changes,iOS:✅ Android:✅ IDE:✅
bindpoitapeventhandlenoTriggered when the map poi point is clicked, e.detail = {name, longitude, latitude}iOS:✅ Android:✅ IDE:❌
bindanchorpointtapeventhandlenoWhen the positioning mark is clicked, e.detail = {longitude, latitude}iOS:✅ Android:✅ IDE:❌

marker ​

attributeIntroductionstypeRequiredRemarksSupport Level
idMarker point idnumbernomarker Click the event callback to return this idiOS:✅ Android:✅ IDE:✅
clusterIdAggregate cluster idnumbernoTo customize the point cluster effectiOS:❌ Android:✅ IDE:❌
joinClusterParticipate in point aggregationBooleannoDefault does not participate in point aggregationiOS:❌ Android:✅ IDE:❌
latitudelatitudenumberyesFloating point number, range -90 90iOS:✅ Android:✅ IDE:✅
longitudeFloating point number, range -90 90numberyesFloating point number, range -180 180iOS:✅ Android:✅ IDE:✅
titleCalling-outstringnoShown when clicked, and ignored when callout existsiOS:✅ Android:✅ IDE:✅
zIndexDisplay levelnumbernoiOS:✅Android:✅ IDE:✅
iconPathDisplay iconsstringyesProject directory under the picture path, support network path, local path, code package pathiOS:✅ Android:✅ IDE:✅
rotateRotation anglenumbernoThe angle of a clockwise rotation 0 360, default to 0iOS:❌ Android:✅ IDE:✅
alphaAnnotated transparencynumbernodefault 1, no transparency, scope 0 1iOS:❌ Android:✅ IDE:✅
widthLabel icon widthnumber/stringnoDefault is the actual width of the pictureiOS:✅ Android:✅ IDE:✅
heightMark icon heightnumbernoDefault is the actual height of the pictureiOS:✅ Android:✅ IDE:✅
calloutDefault is the actual height of the pictureObjectnoThe supported properties are shown in the following table and are recognized as newlines.iOS:✅ Android:✅ IDE:✅
customCalloutCustom bubble windownumbernoiOS:✅ Android:✅ IDE:❌
labelAdd labels next to marker pointsObjectnoThe supported properties are shown in the following table and are recognized as newlines.iOS:❌ Android:❌ IDE:✅
anchorLatitude and longitude at anchor point of callout icon, default bottom midpointObjectno{x, y}, x Represent horizontal(0-1), y Vertical(0-1). {x: .5, y: 1} Represents the midpoint of the bottomiOS:❌ Android:✅ IDE:✅
aria-labelAccessibility, additional description of (attribute) elementsstringnoiOS:❌ Android:❌ IDE:❌

marker Bubbles on top callout ​

attributeIntroductionstypeRemarksSupport Level
contenttextstringiOS:✅ Android:✅ IDE:✅
colorText colorstringiOS:✅ Android:✅ IDE:❌
fontSizeText sizenumberiOS:✅ Android:✅ IDE:❌
borderRadiusBorder filletnumberiOS:✅ Android:✅ IDE:✅
borderWidthBorder widthstringiOS:✅ Android:✅ IDE:❌
borderColorBorder colorstringiOS:✅ Android:✅ IDE:❌
bgColorBackground colorstringiOS:✅ Android:✅ IDE:❌
paddingText marginnumberiOS:❌ Android:✅ IDE:❌
display'BYCLICK ': Click Show 'Always': Chang HinstringiOS:❌ Android:❌ IDE:❌
textAlignText alignment. Valid value: left, right, centerstringiOS:✅ Android:✅ IDE:❌
anchorXLateral offset, positive to the rightnumberiOS:✅ Android:✅ IDE:❌
anchorYVertical offset, positive downwardnumberiOS:✅ Android:✅ IDE:❌

marker Custom bubbles on customCallout ​

The callout and title attributes are ignored when customCallout exists. The custom bubble adopts cover-view customization, which is more flexible.

attributeIntroductionstypeRemarksSupport Level
display'BYCLICK ': Click Show 'Always': Chang HinstringiOS:❌ Android:❌ IDE:❌
anchorXLateral offset, positive to the rightnumberiOS:✅ Android:✅ IDE:❌
anchorYVertical offset, positive downwardnumberiOS:✅ Android:✅ IDE:❌

The slot node named callout is added to the map component. Its internal cover-view is bound to the marker through the mark-id attribute. When the marker is created, the content displayed by the cover-view will be displayed as a callout above the marker point.

js
<map>
  <cover-view slot="callout">
    <cover-view marker-id="1"></cover-view>
    <cover-view marker-id="2"></cover-view>
    <cover-view marker-id="3"></cover-view>
  </cover-view>
</map>

marker Bubbles on top label ​

attributeIntroductionstypeRemarksSupport Level
contenttextstringiOS:❌ Android:❌ IDE:✅
colorText colorstringiOS:❌ Android:❌ IDE:❌
fontSizeText sizenumberiOS:❌ Android:❌ IDE:❌
anchorXThe coordinates of the label, the origin is marker Corresponding latitude and longitudenumberiOS:❌ Android:❌ IDE:❌
anchorYThe coordinates of the label, the origin is marker Corresponding latitude and longitudenumberiOS:❌ Android:❌ IDE:❌
borderWidthBorder widthnumberiOS:❌ Android:❌ IDE:❌
borderColorBorder colorstringiOS:❌ Android:❌ IDE:❌
borderRadiusBorder filletnumberiOS:❌ Android:❌ IDE:❌
bgColorBackground colorstringiOS:❌ Android:❌ IDE:❌
paddingText marginnumberiOS:❌ Android:❌ IDE:❌
textAlignText alignment. Valid value: left, right, centerstringiOS:❌ Android:❌ IDE:❌

polyline ​

attributeIntroductionstypeRequiredRemarksSupport Level
pointsLongitude and latitude arrayarrayyes[{latitude: 0, longitude: 0}]iOS:✅ Android:✅ IDE:✅
colorThe color of the linestringnoHexadecimaliOS:✅ Android:✅ IDE:✅
colorListThe color of the linearraynoIgnore when present color valueiOS:❌ Android:✅ IDE:❌
widthWidth of linenumbernoiOS:✅ Android:✅ IDE:✅
dottedLineWhether dashed linesbooleannodefault falseiOS:❌ Android:✅ IDE:✅
arrowLineLines with arrowsbooleannodefault falseiOS:❌ Android:✅ IDE:✅
arrowIconPathReplace Arrow Iconstringnoin arrowLine for true EffectiveiOS:✅ Android:✅ IDE:✅
borderColorBorder color of linestringnoiOS:❌ Android:❌ IDE:✅
borderWidthThickness of linenumbernoiOS:❌ Android:❌ IDE:✅
levelGland relationstringnoin arrowLine for true EffectiveiOS:❌
Android:✅ aboveroads Equivalent to abovebuildings
IDE:✅

polygon ​

attributeIntroductionstypeRequiredRemarksSupport Level
pointsLongitude and latitude arrayarrayyes[{latitude: 0, longitude: 0}]iOS:✅ Android:✅ IDE:✅
strokeWidthWidth of strokenumbernoiOS:✅ Android:✅ IDE:✅
strokeColorStroke colorstringnoGland relationiOS:✅ Android:✅ IDE:✅
fillColorFill colorstringnoGland relationiOS:✅ Android:✅ IDE:✅
zIndexSet polygon z-axis valuenumbernoiOS:✅ Android:✅ IDE:✅
levelGland relationstringnoDefault is abovelabelsiOS:❌
Android:✅ aboveroads Equivalent to abovebuildings
IDE:✅

circle ​

attributeIntroductionstypeRequiredRemarksSupport Level
latitudelatitudenumberyesFloating point number, range -90 90iOS:✅ Android:✅ IDE:✅
longitudelongitudenumberyesFloating point number, range -180 180iOS:✅ Android:✅ IDE:✅
colorStroke colorstringnoHexadecimaliOS:✅ Android:✅ IDE:✅
fillColorFill colorstringnoHexadecimaliOS:✅ Android:✅ IDE:✅
radiusRadiusnumberyesiOS:✅ Android:✅ IDE:✅
strokeWidthWidth of strokenumbernoiOS:✅ Android:✅ IDE:✅
levelGland relationstringnoDefault is abovelabelsiOS:❌
Android:✅ aboveroads Equivalent to abovebuildings
IDE:✅

control ​

attributeIntroductionstypeRequiredRemarksSupport Level
idControl idnumbernoClicking on an event callback in a control returns this idiOS:❌ Android:❌ IDE:✅
positionControl idobjectyesClicking on an event callback in a control returns this idiOS:❌ Android:❌ IDE:✅
iconPathDisplay iconsstringyesProject directory picture path, support local path, code package pathiOS:❌ Android:❌ IDE:✅
clickableIs it clickable?booleannoDefault not clickableiOS:❌ Android:❌ IDE:✅

position ​

attributeIntroductionstypeRequiredRemarksSupport Level
leftHow far from the left edge of the map?numbernoDefaults to 0iOS:❌ Android:❌ IDE:✅
topHow far to the upper boundary of the map?numbernoDefaults to 0iOS:❌ Android:❌ IDE:✅
widthControl WidthnumbernoDefaults to 0iOS:❌ Android:❌ IDE:✅
heightControl HeightnumbernoDefaults to 0iOS:❌ Android:❌ IDE:✅

Baidu Maps (iOS, Android support only) ​

attributetypeDefault valueRequiredIntroductionsSupport Level
longitudenumber116.46yesCentral longitudeiOS:✅ Android:✅
latitudenumber39.92yesCentral latitudeiOS:✅ Android:✅
scalenumber16noZoom level, values range from 3-20iOS:✅ Android:✅
min-scalenumber3noMinimum Zoom LeveliOS:✅
Android:✅
max-scalenumber20noMaximum zoom leveliOS:✅
Android:✅
markersArray.markernoMarker pointiOS:✅ Android:✅
polylineArray.polylinenorouteiOS:✅ Android:✅
circlesArray.circlenocirculariOS:✅ Android:✅
controlsArray.controlnoControl is about to be deprecated and recommended cover-view Substitute)iOS:❌ Android:❌
include-pointsArray.pointnoScale the field of view to include all the given coordinate pointsiOS:✅ Android:✅
show-locationbooleanfalsenoDisplays the current anchor point with directioniOS:✅ Android:✅
polygonsArray.polygonnopolygoniOS:✅ Android:✅
subkey-noKey to personalize map usageiOS:❌ Android:❌
layer-style-noPersonalized Map Configuration Style, does not support dynamic modificationiOS:❌ Android:❌
rotatenumber0noAngle of rotation 0 360, Map due north and equipment and Angle of axis angleiOS:✅ Android:✅
skewnumber0noAngle, range 0 40 , about with Inclination angle of shaftiOS:✅ Android:✅
enable-3DbooleanfalsenoAngle, range 0 40 , about with Inclination angle of shaftiOS:✅ Android:✅
show-compassbooleanfalsenoShow compassiOS:✅ Android:✅
show-scalebooleanfalsenoDisplay scale, tool does not supportiOS:✅ Android:✅
enable-overlookingbooleanfalsenoOpen up OverlookiOS:✅ Android:✅
enable-zoombooleantruenoWhether scaling is supportediOS:✅ Android:✅
enable-scrollbooleantruenoDrag supportediOS:✅ Android:✅
enable-rotatebooleanfalsenoSupport for rotationiOS:✅ Android:✅
enable-satellitebooleanfalsenoWhether to turn on satellite imageryiOS:✅ Android:✅
enable-trafficbooleanfalsenoWhether to turn on real-time trafficiOS:✅ Android:✅
enable-poibooleantruenoWhether to show THEN pointiOS:✅ Android:✅
enable-buildingbooleannoWhether to display buildingsiOS:❌ Android:❌
settingobjectnoConfiguration itemiOS:✅ Android:✅
bindtapeventhandlenoConfiguration itemiOS:✅ Android:✅
bindmarkertapeventhandlenoTriggered when the marker point is clicked, e.detail = {markerId}iOS:✅ Android:✅
bindlabeltapeventhandlenoTriggered when the label is clicked, e.detail = {markerId}iOS:❌ Android:❌
bindcontroltapeventhandlenoTriggered when the control is clicked, e.detail = {controlId}iOS:❌ Android:❌
bindcallouttapeventhandlenoWhen you click on the bubble corresponding to the marker point, e.detail = {markerId}iOS:✅ Android:✅
bindupdatedeventhandlenoTriggered when the map render update is completeiOS:✅ Triggered only when map loading is complete Android:✅ Triggered only when map loading is complete
bindregionchangeeventhandlenoTriggered when visual field changesiOS:✅ Android:✅
bindpoitapeventhandlenoTriggered when the map poi point is clicked, e.detail = {name, longitude, latitude}iOS:✅ Android:✅
bindanchorpointtapeventhandlenoWhen the positioning mark is clicked, e.detail = {longitude, latitude}iOS:✅ Android:✅

marker ​

attributeIntroductionstypeRequiredRemarksSupport Level
idMarker point idnumbernomarker Click the event callback to return this idiOS:✅ Android:✅
clusterIdAggregate cluster idnumbernoTo customize the point cluster effectiOS:✅ Android:✅
joinClusterParticipate in point aggregationBooleannoDefault does not participate in point aggregationiOS:❌ Android:✅
latitudelatitudenumberyesFloating point number, range -90 90iOS:✅ Android:✅
longitudelongitudenumberyesFloating point number, range -180 180iOS:✅ Android:✅
titleCalling-outstringnoShown when clicked, and ignored when callout existsiOS:✅ Android:✅
zIndexDisplay levelnumbernoiOS:✅ Android:✅
iconPathDisplay iconsstringyesProject directory under the picture path, support network path, local path, code package pathiOS:✅ Android:✅
rotateRotation anglenumbernoThe angle of a clockwise rotation 0 360, default to 0iOS:❌ Android:✅
alphaAnnotated transparencynumbernodefault 1, no transparency, scope 0 1iOS:❌ Android:✅
widthLabel icon widthnumber/stringnodefault 1, no transparency, scope 0 1iOS:✅ Android:✅
heightMark icon heightnumbernoDefault is the actual height of the pictureiOS:✅ Android:✅
calloutBubble window above the marker pointObjectnoThe supported properties are shown in the following table and are recognized as newlines.iOS:✅ Android:✅
customCalloutCustom bubble windowobjectnoiOS:✅ Android:✅
labelAdd labels next to marker pointsObjectnoThe supported properties are shown in the following table and are recognized as newlines.iOS:❌ Android:❌
anchorLatitude and longitude at anchor point of callout icon, default bottom midpointObjectno{x, y}, x Represent horizontal(0-1), y Vertical(0-1). {x: .5, y: 1} Represents the midpoint of the bottomiOS:✅ Android:✅
aria-labelAccessibility, additional description of (attribute) elementsstringnoiOS:❌ Android:❌

marker Bubbles on top callout ​

attributeIntroductionstypeRemarksSupport Level
contenttextstringiOS:✅ Android:✅
colorText colorstringiOS:✅ Android:✅
fontSizeText sizenumberiOS:✅ Android:✅
borderRadiusBorder filletnumberiOS:✅ Android:✅
borderWidthBorder widthstringiOS:✅ Android:✅
borderColorBorder colorstringiOS:✅ Android:✅
bgColorBackground colorstringiOS:✅ Android:✅
paddingText marginnumberiOS:✅ Android:✅
display'BYCLICK ': Click Show 'Always': Chang HinstringiOS:❌ Android:✅
textAlignText alignment. Valid value: left, right, centerstringiOS:✅ Android:✅
anchorXLateral offset, positive to the rightnumberiOS:✅ Android:❌
anchorYVertical offset, positive downwardnumberiOS:✅ Android:✅

marker Bubbles on top customCallout ​

The callout and title attributes are ignored when customCallout exists. The custom bubble adopts cover-view customization, which is more flexible.

attributeIntroductionstypeRemarksSupport Level
display'BYCLICK ': Click Show 'Always': Chang HinstringiOS:❌ Android:✅
anchorXLateral offset, positive to the rightnumberiOS:✅ Android:✅
anchorYVertical offset, positive downwardnumberiOS:✅ Android:✅

The slot node named callout is added to the map component. Its internal cover-view is bound to the marker through the mark-id attribute. When the marker is created, the content displayed by the cover-view will be displayed as a callout above the marker point.

js
<map>
  <cover-view slot="callout">
    <cover-view marker-id="1"></cover-view>
    <cover-view marker-id="2"></cover-view>
    <cover-view marker-id="3"></cover-view>
  </cover-view>
</map>

marker Bubbles on top label ​

attributeIntroductionstypeRemarksSupport Level
contenttextstringiOS:❌ Android:❌
colorText colorstringiOS:❌ Android:❌
fontSizeText sizenumberiOS:❌ Android:❌
anchorXThe coordinates of the label, the origin is marker Corresponding latitude and longitudenumberiOS:❌ Android:❌
anchorYThe coordinates of the label, the origin is marker Corresponding latitude and longitudenumberiOS:❌ Android:❌
borderWidthBorder widthnumberiOS:❌ Android:❌
borderColorBorder colorstringiOS:❌ Android:❌
borderRadiusBorder filletnumberiOS:❌ Android:❌
bgColorBackground colorstringiOS:❌ Android:❌
paddingText marginnumberiOS:❌ Android:❌
textAlignText alignment. Valid value: left, right, centerstringiOS:❌ Android:❌

polyline ​

attributeIntroductionstypeRequiredRemarksSupport Level
pointsLongitude and latitude arrayarrayyes[{latitude: 0, longitude: 0}]iOS:✅ Android:✅
colorThe color of the linestringnoHexadecimaliOS:✅ Android:✅
colorListRainbow linearraynoIgnore when present color valueiOS:✅ Android:✅ IDE:❌
widthWidth of linenumbernoiOS:✅ Android:✅
dottedLineWhether dashed linesbooleannodefault falseiOS:❌ Android:✅
arrowLineLines with arrowsbooleannodefault falseiOS:❌ Android:✅
arrowIconPathReplace Arrow Iconstringnoin arrowLine for true EffectiveiOS:✅ Android:✅
borderColorBorder color of linestringnoiOS:❌ Android:❌
borderWidthThickness of linenumbernoiOS:❌ Android:❌
levelGland relationstringnoDefault is abovelabelsiOS:❌ Android:❌

polygon ​

attributeIntroductionstypeRequiredRemarksSupport Level
pointsLongitude and latitude arrayarrayyes[{latitude: 0, longitude: 0}]iOS:✅ Android:✅
strokeWidthWidth of strokenumbernoiOS:✅ Android:✅
strokeColorStroke colorstringnoHexadecimaliOS:✅ Android:✅
fillColorFill colorstringnoHexadecimaliOS:✅ Android:✅
zIndexSet polygon z-axis valuenumbernoiOS:✅ Android:✅
levelGland relationstringnoDefault is abovelabelsiOS:❌ Android:❌

circle ​

attributeIntroductionstypeRequiredRemarksSupport Level
latitudelatitudenumberyesFloating point number, range -90 90iOS:✅ Android:✅
longitudelongitudenumberyesFloating point number, range -180 180iOS:✅ Android:✅
colorStroke colorstringnoHexadecimaliOS:✅ Android:✅
fillColorFill colorstringnoHexadecimaliOS:✅ Android:✅
radiusRadiusnumberyesiOS:✅ Android:✅
strokeWidthWidth of strokenumbernoiOS:✅ Android:✅
levelGland relationstringnoDefault is abovelabelsiOS:❌ Android:❌

control ​

attributeIntroductionstypeRequiredRemarksSupport Level
idControl idnumbernoClicking on an event callback in a control returns this idiOS:❌ Android:❌
positionControl location on the mapobjectyesControl relative map positioniOS:❌ Android:❌
iconPathDisplay iconsstringyesProject directory picture path, support local path, code package pathiOS:❌ Android:❌
clickableIs it clickable?booleannoDefault not clickableiOS:❌ Android:❌

position ​

attributeIntroductionstypeRequiredRemarksSupport Level
leftHow far from the left edge of the map?numbernoDefaults to 0iOS:❌ Android:❌
topHow far to the upper boundary of the map?numbernoDefaults to 0iOS:❌ Android:❌
widthControl WidthnumbernoDefaults to 0iOS:❌ Android:❌
heightControl HeightnumbernoDefaults to 0iOS:❌ Android:❌

Google Maps (Android support only) ​

attributeIntroductionstypeRequiredRemarksSupport Level
longitudenumber116.46yesCentral longitude✅
latitudenumber39.92yesCentral latitude✅
scalenumber16noZoom level, values range from 3-20✅
min-scalenumber3noMinimum Zoom Level✅
max-scalenumber20noMaximum zoom level✅
markersArray.markernoMarker point✅
polylineArray.polylinenoroute✅
circlesArray.circlenocircular✅
controlsArray.controlnoControl is about to be deprecated and recommended cover-view Substitute)❌
include-pointsArray.pointnoScale the field of view to include all the given coordinate points✅
show-locationbooleanfalsenoDisplays the current anchor point with direction✅
polygonsArray.polygonnopolygon✅
subkey-noPersonalized Map Configuration Style, does not support dynamic modification❌
layer-style-noPersonalized Map Configuration Style, does not support dynamic modification❌
rotatenumber0noAngle of rotation 0 360, Map due north and equipment and Angle of axis angle✅
skewnumber0noAngle, range 0 40 , about with Inclination angle of shaft✅
enable-3DbooleanfalsenoDisplay 3D block(Tools not supported)❌
show-compassbooleanfalsenoShow compass✅
show-scalebooleanfalsenoDisplay scale, tool does not support❌
enable-overlookingbooleanfalsenoOpen up Overlook✅
enable-zoombooleantruenoWhether scaling is supported✅
enable-scrollbooleantruenoDrag supported✅
enable-rotatebooleanfalsenoSupport for rotation✅
enable-satellitebooleanfalsenoWhether to turn on satellite imagery✅
enable-trafficbooleanfalsenoWhether to turn on real-time traffic✅
enable-poibooleantruenoWhether to show THEN point✅
enable-buildingbooleannoWhether to display buildings✅
settingobjectnoConfiguration item✅
bindtapeventhandlenoTriggered when the map is clicked, Return latitude and longitude information✅
bindmarkertapeventhandlenoTriggered when the marker point is clicked, e.detail = {markerId}✅
bindlabeltapeventhandlenoTriggered when the label is clicked, e.detail = {markerId}❌
bindcontroltapeventhandlenoTriggered when the control is clicked, e.detail = {controlId}❌
bindcallouttapeventhandlenoWhen you click on the bubble corresponding to the marker point, e.detail = {markerId}✅
bindupdatedeventhandlenoTriggered when the map render update is complete✅ Triggered only when map loading is complete
bindregionchangeeventhandlenoTriggered when visual field changes✅
bindpoitapeventhandlenoTriggered when the map poi point is clicked, e.detail = {name, longitude, latitude}✅
bindanchorpointtapeventhandlenoWhen the positioning mark is clicked, e.detail = {longitude, latitude}✅

marker ​

attributeIntroductionstypeRequiredRemarksSupport Level
idMarker point idnumbernomarker Click the event callback to return this id✅
clusterIdAggregate cluster idnumbernoTo customize the point cluster effect✅
joinClusterParticipate in point aggregationBooleannoDefault does not participate in point aggregation✅
latitudelatitudenumberyesFloating point number, range -90 90✅
longitudelongitudenumberyesFloating point number, range -180 180✅
titleCalling-outstringnoShown when clicked, and ignored when callout exists✅
zIndexDisplay levelnumberno✅
iconPathDisplay iconsstringyesProject directory under the picture path, support network path, local path, code package path✅
rotateRotation anglenumbernoThe angle of a clockwise rotation 0 360, default to 0✅
alphaAnnotated transparencynumbernodefault 1, no transparency, scope 0 1✅
widthLabel icon widthnumber/stringnoDefault is the actual width of the picture✅
heightMark icon heightnumbernoDefault is the actual height of the picture✅
calloutBubble window above the marker pointObjectnoThe supported properties are shown in the following table and are recognized as newlines.✅
customCalloutCustom bubble windowobjectno✅
labelAdd labels next to marker pointsObjectnoThe supported properties are shown in the following table and are recognized as newlines.❌
anchorLatitude and longitude at anchor point of callout icon, default bottom midpointObjectno{x, y}, x Represent horizontal(0-1), y Vertical(0-1). {x: .5, y: 1} Represents the midpoint of the bottom✅
aria-labelAccessibility, additional description of (attribute) elementsstringno❌

marker Bubbles on top callout ​

attributeIntroductionstypeRemarksSupport Level
contenttextstring✅
colorText colorstring✅
fontSizeText sizenumber✅
borderRadiusBorder filletnumber✅
borderWidthBorder widthstring✅
borderColorBorder colorstring✅
bgColorBackground colorstring✅
paddingText marginnumber✅
display'BYCLICK ': Click Show 'Always': Chang Hinstring❌
textAlignText alignment. Valid value: left, right, centerstring✅
anchorXLateral offset, positive to the rightnumber✅
anchorYVertical offset, positive downwardnumber✅

marker Bubbles on top customCallout ​

The callout and title attributes are ignored when customCallout exists. The custom bubble adopts cover-view customization, which is more flexible.

attributeIntroductionstypeRemarksSupport Level
display'BYCLICK ': Click Show 'Always': Chang Hinstring❌
anchorXLateral offset, positive to the rightnumber✅
anchorYVertical offset, positive downwardnumber✅

The slot node named callout is added to the map component. Its internal cover-view is bound to the marker through the mark-id attribute. When the marker is created, the content displayed by the cover-view will be displayed as a callout above the marker point.

js
<map>
  <cover-view slot="callout">
    <cover-view marker-id="1"></cover-view>
    <cover-view marker-id="2"></cover-view>
    <cover-view marker-id="3"></cover-view>
  </cover-view>
</map>

marker Bubbles on top label ​

attributeIntroductionstypeRemarksSupport Level
contenttextstring❌
colorText colorstring❌
fontSizeText sizenumber❌
anchorXThe coordinates of the label, the origin is marker Corresponding latitude and longitudenumber❌
anchorYThe coordinates of the label, the origin is marker Corresponding latitude and longitudenumber❌
borderWidthBorder widthnumber❌
borderColorBorder colorstring❌
borderRadiusBorder filletnumber❌
bgColorBackground colorstring❌
paddingText marginnumber❌
textAlignText alignment. Valid value: left, right, centerstring❌

polyline ​

attributeIntroductionstypeRequiredRemarksSupport Level
pointsLongitude and latitude arrayarrayyes[{latitude: 0, longitude: 0}]✅
colorThe color of the linestringnoHexadecimal✅
colorListRainbow linearraynoIgnore when present color value❌
widthWidth of linenumberno✅
dottedLineWhether dashed linesbooleannodefault false❌
arrowLineLines with arrowsbooleannodefault false❌
arrowIconPathReplace Arrow Iconstringnoin arrowLine for true Effective❌
borderColorBorder color of linestringno❌
borderWidthThickness of linenumberno❌
levelGland relationstringnoDefault is abovelabels❌

polygon ​

attributeIntroductionstypeRequiredRemarksSupport Level
pointsLongitude and latitude arrayarrayyes[{latitude: 0, longitude: 0}]✅
strokeWidthWidth of strokenumberno✅
strokeColorStroke colorstringnoHexadecimal✅
fillColorFill colorstringnoHexadecimal✅
zIndexSet polygon z-axis valuenumberno✅
levelGland relationstringnoDefault is abovelabels❌

circle ​

attributeIntroductionstypeRequiredRemarksSupport Level
latitudelatitudenumberyesFloating point number, range -90 90✅
longitudelongitudenumberyesFloating point number, range -180 180✅
colorStroke colorstringnoHexadecimal✅
fillColorFill colorstringnoHexadecimal✅
radiusRadiusnumberyes✅
strokeWidthWidth of strokenumberno✅
levelGland relationstringnoDefault is abovelabels❌

control ​

attributeIntroductionstypeRequiredRemarksSupport Level
idControl idnumbernoClicking on an event callback in a control returns this id❌
positionControl location on the mapobjectyesControl relative map position❌
iconPathDisplay iconsstringyesProject directory picture path, support local path, code package path❌
clickableIs it clickable?booleannoDefault not clickable❌

position ​

attributeIntroductionstypeRequiredRemarksSupport Level
leftHow far from the left edge of the map?numbernoDefaults to 0❌
topHow far to the upper boundary of the map?numbernoDefaults to 0❌
widthControl WidthnumbernoDefaults to 0❌
heightControl HeightnumbernoDefaults to 0❌