Map Input Tool Icon

Map Input Tool

Last modified: May 04, 2022

One Tool Example

Map Input has a One Tool Example. Visit Sample Workflows to learn how to access this and many other examples directly in Alteryx Designer.

Use Map Input to draw or select the desired map object to use as an input in a workflow. You can draw or select a point, line, or polygon from a map that displays a reference base map like TomTom or DigitalGlobe.

You can set a reference base map as default and even set the default map bounds for the Map Input tool from User Settings. Go to Options > User Settings > Edit User Settings and select the Dataset Defaults tab. 

Configure the Tool

  1. Mode: Select from 1 of 2 options for configuring the Map Input tool:
    • Draw: Draw points, lines, or polygons (spatial objects) directly on a map. Optionally, a reference file containing spatial objects can be viewed. Spatial objects can be identified with a label, and the label is passed downstream along with the spatial object data.
      • Pan around on the map and/or use the zoom in/out slider to get the map in the desired position for object placement.
      • Select the type of object to draw on the map (point, line, or polygon.)
      • Place the object by clicking directly on the map.
      • Double-click to close a polygon or complete drawing a line.
      • Once an object is drawn, you are prompted to specify a label for the drawn object.
      • Select a map to rename, modify, or delete the object.
    • Select: ­­­­Select points and polygons from a reference layer. The selected objects are used as the input for the workflow.
      • Select Individual objects, or use a bounding box to select all points, lines, and polygons within.
      • Press Ctrl + Click to select additional individual objects.
  2. Base Map: Dropdown list to specify which set of reference layers to include within the map image. The list includes all mapfile and layersets currently installed.
  3. Reference yxdb Use the file browse to specify a .yxdb file with spatial objects to display on the map. The map automatically zooms to the extent of this layer. Depending on the mode you choose, you can select objects from this layer to pass through the tool or draw their own objects. If you browse to a file on the Map Input tool which is on a mapped drive, then the file will not be found as it cannot exist in the persistence layer. In this instance, the file cannot be rendered, and only non-mapped files can be used.
  4. Label Field: Dropdown list of fields from the reference YXDB specified above. You can pick a field to display on the map.
Was This Page Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support. Can't submit this form? Email us.