Instance Method


Adds an array of overlay objects to the map at the specified level.


- (void)addOverlays:(NSArray<id<MKOverlay>> *)overlays level:(MKOverlayLevel)level;



The array of overlay objects to add. Each object in the array must conform to the MKOverlay protocol.


The map level at which to place the overlays. For a list of possible values for this parameter, see MKOverlayLevel.


Positioning an overlay at a specific level places that overlay’s visual representation in front of or behind other map content such as map labels and point-of-interest icons.

This method adds the specified overlays to the end of the list of overlay objects at the given level. Adding the overlays also causes the map view to begin monitoring the area they represent. As soon as the bounding rectangle of an overlay intersects the visible portion of the map, the map view calls your delegate’s mapView:rendererForOverlay: method to get the renderer object to use when drawing that overlay.

To remove multiple overlays from a map, use the removeOverlays: method.

See Also

Adding and Inserting Overlays

- addOverlay:level:

Adds the overlay object to the map at the specified level.

- addOverlay:

Adds a single overlay object to the map.

- addOverlays:

Adds an array of overlay objects to the map.

- insertOverlay:atIndex:level:

Inserts an overlay object into the level at the specified index.

- insertOverlay:atIndex:

Inserts an overlay object into the list associated with the map.

- insertOverlay:aboveOverlay:

Inserts one overlay object on top of another.

- insertOverlay:belowOverlay:

Inserts one overlay object below another.

- exchangeOverlay:withOverlay:

Exchanges the positions of the two overlay objects.

- exchangeOverlayAtIndex:withOverlayAtIndex:

Exchanges the position of two overlay objects.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software