Raster tile layer (v4.x)

Chart style

The raster tile layer is a sub-widget of the Basic Flat Map 4.0 that supports independent style and interaction configurations, including tile templates, display content, and filters. You can connect to the latest Amap online map as a tile source and customize the map style.

Style panel

• Search Configuration: Click the icon in the upper-right corner of the Style panel to search for configuration items by name. Fuzzy matching is supported. Search for a configuration item.

• Quick styles: Provides preset styles for the raster tile layer. Select a style that suits your scenario.

• General: General configuration parameters for the raster tile layer.

  Parameter	Description
  Visibility Level	The visibility level range of the raster tile layer. Valid values: 0 to 22. The layer is visible within the specified range and hidden outside of it.
  Opacity	The opacity of the raster tile layer, in percent. Valid values: 0 to 100. A larger value makes the layer more opaque.

• Graphics: Graphic style configuration parameters for the raster tile layer.

  • Tile Category: Select the tile type for the map layer. The options are Standard Tile and WMS Tile.

    • Standard Tile: Available only when Tile Category is set to Standard Tile.

      Parameter	Description
      Tile URL	Select a built-in tile URL style from the drop-down list. Options include Amap Electronic Map and Amap Satellite Map. Note You can delete the preset maps from the drop-down list and enter a custom tile URL.
      Tile Size	Valid values: 256 and 512. Use the default unless your tile service outputs a different tile size.
      Zoom Offset	The zoom offset of the tile layer. Valid values: -10 to 10. Default value: 0. This parameter takes effect only when the parent container uses a custom coordinate system.
      TMS Protocol	Enable this switch to render tiles using the Tile Map Service (TMS) protocol.

    • WMS Tile: Available only when Tile Category is set to WMS Tile.

      Parameter	Description
      Service Endpoint	Enter a custom WMS service endpoint. If you leave this empty, the default service endpoint is used.
      Layer List	The layer list required for the custom WMS service endpoint.
      Image Style	Select an image format from the drop-down list. Options: image/png and image/jpeg. Select image/png if the service contains transparent areas.
      Pan X	The pan amount of the WMS tile on the x-axis.
      Pan Y	The pan amount of the WMS tile on the y-axis.

  • Zoom Range: The layer is not displayed if the map's zoom level is outside the General > Visible Level range. If the zoom level is within this range but outside the Graphic > Zoom Range, the layer is rendered using tiles from the maximum or minimum value of the Graphic > Zoom Range.

  • Auto-refresh: Enable this switch to automatically refresh tile data at the interval specified in Refresh Interval.

    Note

    Enable this option when you use tile services such as Amap Heatmap or Amap Real-time Traffic to retrieve the latest tile data automatically.

    Refresh Interval: The time interval for automatic tile refresh, in minutes. Valid values: 1 to 100.

  • Overlay Mask: Click the icon on the left to enable the overlay mask and set its color. For more information, see Color picker.

  • Style Filter: Click the icon on the left to enable and configure a filter effect for the tile layer. You can set the Brightness, Contrast, Grayscale, Hue, Invert, Saturation, and Sepia of the filter.

Advanced panel

Configure interaction events or associate global variables for filter interactions between widgets. Configure widget interactions.

Blueprint interaction

1. Click the icon in the upper-left corner of the page to open the Blueprint page.

2. On the Layer Node tab, add the current widget to the main canvas.

3. View the blueprint configuration parameters.

   Note

   Click the icon in the anchor point area on the right to view event and action parameter tooltips.

   • Events:

     Event	Description
     Component Loaded	Triggered after the data API response is returned and processed by the filter. The processed data is output in JSON format. For a data example, see the Data Response area on the Data Source tab of the widget configuration panel in the canvas editor.

   • Actions

     Action	Description
     Toggle Visibility	The Toggle visibility, Show, and Hide widget actions do not require parameters by default. You can add animation configurations as needed. See the reference data example. { // Animation type. Options: appear, fade, slideToUp. Default: fade. If left blank, there is no animation. "animationType": "fade", // Animation duration. Default: 1000. Unit: ms. "animationDuration": 1000, // Animation curve. Options: linear, easeInOutQuad, easeInOutExpo. Default: linear. "animationEasing": "linear" }
     Show
     Hide
     Update Widget Configuration	Dynamically updates the widget style configuration. Click Copy Configuration to Clipboard in the widget Style panel to get the configuration data, then modify the field values in the data processing node on the blueprint editor page.