[wf9a5m75]

なぜ

利用者の決定で、すべてのプロバイダ・3 プラットフォームで、オーバーレイを下から次の順に重ねます。

1. ラスターレイヤー（RasterLayerState）
2. GroundImage
3. ポリゴン（ネイティブのポリゴンと、ポリゴンのタイルレイヤーが同じ帯）
4. サークル
5. ポリライン
6. マーカー（ネイティブのマーカーと、マーカーのタイルレイヤーが同じ帯）

追加した順・送り直した順（clearOverlays の後など）・デザイン変更の後に左右されません。帯の中は zIndex、同じ zIndex なら渡された順です。

プロバイダごとに重なり順がばらばらでした（TomTom のラスターがポリゴンを覆う、送り直した GroundImage がポリゴンより上に来る、GL 系でサークルがポリゴンの下になる、など）。

何を変えたか

ポリゴン・サークル・ポリライン・マーカーは drawOrder に生の zIndex（既定 0）を入れていたので、追加の順で決まっていました。100 幅の帯の globalZIndex にしました（4096 幅では実機でサークルがポリゴンの下に描かれたため）。既定のシーンに足したポリラインは drawOrder に関係なくポリゴン・サークル・ラスターの下に描かれるので、renderedLast() の名前付きポリラインレイヤーに入れます。ラスター・GroundImage・マーカータイルの MapLayer には優先度が無かったので、最初の map item より前に空の anchor レイヤーを作り、その後ろに帯の順に繋ぎます。

地図のラベルとの関係（今のまま）

今のままにしています。GL 系（MapLibre・Mapbox・Mappls・MapTiler）はラスターをベースマップの最初のラベルの下、他のオーバーレイはラベルの上です（MapTiler のラスターは、前はすべての上でしたが、他の GL 系に合わせてラベルの下に移りました）。Google はラベルを常にオーバーレイの上に描きます（変更なし）。MapKit だけは変わります: 帯の順を守るために全部を同じレベルに置く必要があり、ラスターと GroundImage が .aboveLabels から .aboveRoads（ラベルの下）へ移りました。ポリゴン・サークル・ポリラインは前からラベルの下です。逆に全部を .aboveLabels にすると、ポリゴン類がラベルの上へ移ります。今回は前者で、利用者の判断で承認済みです。

検証

2026-11-08 に develop（fix/mapview-teardown、fix/geodesic-polygon-fill、fix/clear-followups、refactor/polygon-controller などのマージ後）の上に載せ直してから確かめています。

• ios-sdk-core の単体テスト 368 件すべて成功（OverlayStackingTests は 720 通りの追加順。前の MapLibre の差し込み方に戻すと 4 件落ちます）。api-surface は変化なし（@_spi）。
• 10 プロバイダとも、同じブランチの core と組み合わせて api-surface.sh check が通りました（Longdo は develop のまま＋stacking の core でビルド）。
• develop ＋ fix/clear-strategy ＋ この PR 一式を合わせたアプリが実機向けにビルドでき、iPad 実機で MapLibre / MapKit を撮り直しました。普通に追加・逆の順・clearOverlays → 送り直し・デザイン変更 のどれでも、下から ラスター < GroundImage < ポリゴン < サークル < ポリライン < マーカー でした。
• 載せ直す前に、全プロバイダを直す前・直した後で撮っています（core の PR の表）。

確認できていないもの

• 載せ直した後に撮り直したのは MapLibre / MapKit のみです。develop で動いたのはポリゴンの densify だけで、レイヤーの差し込みには触れていないため、他は載せ直す前の撮影を有効としています。
• ios-for-googlemaps の iOS 16/17 のビルドの問題は既存のまま（develop でも同じ）。
• feat/polygon-tiling（未マージ）のポリゴンタイルは rasterKey(stateId:) でポリゴンの帯に入る用意だけしてあり、実物では確かめていません。

関連 PR（fix/overlay-stacking-order の一式）

• Android: Add OverlayStacking: one bottom-to-top order for every overlay kind android-sdk-core#31、Stack graphics overlays polygon < circle; rasters under ground images android-for-arcgis#26、Map zIndex into the overlay bands android-for-googlemaps#26、Put rasters and ground images under map items; separate draw-order bands android-for-here#20、Stack overlays by band inside the Longdo renderer android-for-longdo#14、Stack overlays by band, independent of add order and style reloads android-for-mapbox#24、Stack overlays by band, independent of add order and style reloads android-for-maplibre#25、Stack overlays by band, independent of add order and style reloads android-for-mappls#16、Stack overlays by band with moveLayer android-for-maptiler#16、Give rasters, ground images and marker tiles their own index bands android-for-openmobilemaps#14、Put app rasters under the SDK overlays; restack native shapes by band android-for-tomtom#16
• iOS: Add OverlayBand and OverlayStacking for one overlay stacking order ios-sdk-core#31、Stack overlays in one band order, whatever order they arrive in ios-for-arcgis#15、Stack overlays in one band order, whatever order they arrive in ios-for-googlemaps#14、Stack overlays in one band order, whatever order they arrive in #11、Stack overlays in one band order, whatever order they arrive in ios-for-mapbox#15、Stack overlays in one band order, whatever order they arrive in ios-for-mapkit#15、Stack overlays in one band order, whatever order they arrive in ios-for-maplibre#15、Stack overlays in one band order, whatever order they arrive in ios-for-mappls#10、Stack overlays in one band order, whatever order they arrive in ios-for-maptiler#11、Keep rasters, ground images and marker tiles in their bands ios-for-openmobilemaps#8、Put raster layers under the labels instead of on top of the style ios-for-tomtom#12
• web: Add the shared overlay stacking order js-sdk-core#30、Put raster layers under the overlays react-for-arcgis#13、Stack overlay layers in one fixed order react-for-azuremaps#13、Put ground images and circles in their own ground zIndex bands react-for-cesium#13、Draw marker tiles with the markers react-for-deckgl#9、Give polygons, circles and polylines separate zIndex bands react-for-googlemaps#16、Stack overlays in one fixed order react-for-here#13、Give each overlay kind its own pane z-index band react-for-leaflet#13、Stack overlay layers in one fixed order react-for-longdo#19、Stack overlay layers in one fixed order react-for-mapbox#20、Keep polygons, circles and polylines in one fixed order react-for-mapkit#14、Stack overlay layers in one fixed order react-for-maplibre#29、Stack overlay layers in one fixed order react-for-mappls#19、Stack overlay layers in one fixed order react-for-maptiler#20、Give each overlay kind its own layer z-index band react-for-openlayers#13、Stack overlay layers in one fixed order react-for-tomtom#20

マージの順番:

1. fix/clear-strategy の一式（先に入れる想定。衝突はしないことを git merge-tree で確認済み）
2. 各プラットフォームの core（android-sdk-core / ios-sdk-core / js-sdk-core）
3. そのプラットフォームのプロバイダ（core の新しいヘルパーを使うので、core より先に入れるとビルドが通りません）

• Android MapTiler は fix/maptiler-overlay-restore の上に載せています（同じ削除処理を両方が書き換えたため）。先に restore の PR（Remove style layers and sources by object so they can come back android-for-maptiler#17）を入れてください。
• web はさらに js-sdk-core の npm 公開と、各 react-for-* の依存の引き上げが前提です（npm 公開はまだしない、という決定なので、web のプロバイダ PR はそれまで保留です）。