Add holes on the map

Map Holes is a feature that lets you mask the entire map, highlighting only specific areas of interest. These areas, known as “holes”, can represent things like city boundaries, continents, streets, and more. Get creative with how you use them!

To add holes to your map, follow these steps:

Step 1: Enable Map Holes Drawing

  1. Edit your map and open the “Progress Map Settings” widget.
  2. Navigate to the “Map holes settings” menu.
  3. Set the “Map holes option” field to “Yes”.

Step 2: Add and Configure Map Holes

  1. Scroll to the “Map holes” section. Click on the group field “Hole 1” or “Add new hole” for additional map holes.
  2. In the field “Hole visibility”, select the option “Yes”.
  3. In the “Hole Label” field, enter the hole’s name or title.
  4. Enter a unique identifier in the “Hole ID/Name” field. Each map hole must have a unique ID/Name.
  5. Specify the “Hole points type” and draw your map hole using one of the following methods:

Method 1: Using Post IDs

        1. Select “Post IDs” in the “Hole points type” field.
        2. In the “Hole Paths (Post IDs)” field, select at least three posts to form the map hole.

Method 2: Using Coordinates

        1. Select “Lat,Lng” in the “Hole points type” field.
        2. Open “Hole Paths” and enter the coordinates in the “Hole coordinates” field using the format [Lat,Lng] or [Lng,Lat]. Example: [45.5215,-1.5245],[41.2587,-1.2479],[40.1649,-1.9879]
        3. Select the coordinates format in the field “LatLngs order”. Refer to the instructions in “Step 5” below to ensure the proper placement and display of your map holes!

Method 3: Draw Directly in the Plugin Settings

        1. Select “Lat,Lng” in the “Hole points type” field.
        2. Open “Hole Paths” and draw your map hole. Use the drawing tool to create the hole directly. Refer to the provided instructions in the field to use the tool.

Step 3: Adding More Map Holes

Click “Add new hole” and repeat the steps above for additional map holes, or save your map settings if you’ve finished adding holes.

Step 4: Verify Holes Placement

To ensure map holes added using “Method 2” are displayed correctly on the frontend map, it’s essential to verify that their coordinate order is “Latitude” followed by “Longitude.” Many services provide coordinates in reverse order, i.e., “Longitude, Latitude”, which can result in holes being displayed incorrectly or not at all.

To resolve this issue, follow these steps:

    1. After adding your map holes, save the map settings.
    2. Revisit the map settings and review each hole by opening the “Hole path” widget to confirm their placement on the map.
    3. If a map hole is misplaced, it may have reversed coordinates. In this case, click the “Reverse coordinates” button at the top of the map. This tool quickly reverses the order of all hole vertices.
    4. Once the hole appears correctly on the map, click “Update/Display hole coordinates” to save the changes.
    5. Save your map settings after verifying the placement of all map holes.

By taking these steps, you ensure your map holes are displayed accurately on the frontend map.

In the same context