mapbox / mapbox/mapbox-maps-ios

Cross-layer symbol collision detection not working on iOS

Open
#2,371 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

auto-triaged feature :green_apple:
Dominant language
Swift
Stars
601
Forks
196
PR merge metrics
No merged PRs in 30d

Description

On Mapbox GL JS, symbol collision detection works globally across all symbol layers - icons from different layers don't overlap with each other.

On Mapbox Maps SDK for iOS v10, collision detection only works within individual layers. Icons from the same layer don't overlap, but icons from different layers can overlap.

**Environment:**
- Mapbox Maps SDK for iOS v10.19.2
- iOS 26

**Setup:**
- Multiple symbol layers with different sources (GeoJSON and vector tile sources)

**Question:**
Is cross-layer collision detection supported in iOS SDK v10, or is this a known platform difference? If it's not supported, is there a recommended approach for preventing symbol overlap across layers when using different source types?

I cannot combine layers into a single source because I need different source types and independent visibility control per layer.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by investigating cross-layer symbol collision behavior in Mapbox Maps SDK for iOS v10.19.2 with multiple symbol layers using GeoJSON and vector tile sources. Determine whether collision detection across layers is supported and document a recommended approach for preventing overlap while retaining independent visibility control.

Written by the indexing model from the issue text.

Assessment

Tech stack
ios, swift
Domain
mobile
Issue type
Bug
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.