[wf9a5m75]

なぜ

ArcGIS で GroundImage が表示されていませんでした（3D・2D とも）。

いつから壊れたかを android-sdk の履歴で切り分けました。

• 42bba2fc（1.3.0 のリリース準備、ArcGIS SDK を 200.7 → 300.1.0 に上げたコミット）から表示されなくなっています。 親の 67d81ec5（ArcGIS 200.7）では、3D の SceneView に University of Eswatini（当時は Newark）の画像が枠どおりに出ていました。42bba2fc では同じページで枠と角のマーカーだけが出て、画像は出ません（タブレット TB520FU で両方を組んで比較）。
• Android の 2D（MapView）は、200.7 の時点でももともと表示されていませんでした。 今回の変更で 2D も表示されるようになります。

原因は GroundImage の WebTiledLayer に渡すレベルの梯子です。512px のタイルなのに、解像度を 256px 基準のまま刻んでいたため、level L のタイルが L-1 の広さを覆い、ArcGIS 300 は番号だけ 1 段深い (z, x, y) を要求していました（例: エスワティニ上空で z=15, x=9618。正しくは z=15 なら x=19235）。GroundImageTileProvider は URL が指すタイルを素直に描くので、どのタイルも画像の外になり、全面透明でした（端末から取得したタイルは 512x512・アルファ 0）。200.x の SceneView は自前の 256px 格子で (col, row) を数えていたので、この読み替えで合っていました。

ラスターレイヤーは d0f4819 で同じ問題を直していましたが、GroundImage は古い梯子のコピーを持ったまま残っていました。

何を変えたか

1. GroundImage の梯子をタイルの一辺どおりに組む（5b3cc2d）。ラスターと GroundImage の解像度・縮尺を WebMercatorTileLevels の 1 か所から取るようにして、片方だけ直す状態に戻らないようにしました。
2. 重なり順の表を同一性で引く（30fbf21）。GroundImage が表示されるようになって見えた問題です。3D で GroundImage を先に載せてからラスターを足すと、ラスターが GroundImage の上に積まれていました。ArcGISOverlayStacking が WeakHashMap<Layer, …> で帯の鍵を持っていて、ArcGIS の Layer は equals / hashCode を上書きしているため、直前に登録した層の鍵が引けないことがありました（ログでは同じ層が「鍵なし」になり、ラスターが一番上に足されていた）。弱参照で持ち、=== で引く表に替えました。

WebMercatorTileLevels と IdentityWeakTable は internal です。API ダンプには ArcGIS2DTiltEmulation と同じく載るので、ベースラインに追加しました（追加のみ）。

検証

• 単体テスト: WebMercatorTileLevelsTest（512px の level が 256px の level+1 と同じ地面を覆うこと等）と IdentityWeakTableTest（鍵の hashCode が変わっても引けること等）を足しました。WebMercatorTileLevelsTest は、GroundImage が持っていた古い読み替え（512 のとき 256 基準）に戻すと 3 件中 2 件落ちます。testDebugUnitTest は全部通過。
• apiCheck: 残る差分は develop に既にある ArcGISMarkerController のコンストラクタのずれ（今回とは無関係）だけです。
• 実機（TB520FU、develop の他モジュールと組み合わせ）:
  • GroundImage のサンプル: 3D・2D とも、画像が枠（SW/NE のマーカー）の中に正しい位置・大きさで出ます。
  • 重なり順の検証ページ（ラスター 0.85 の上にチェッカーの GroundImage、その上にポリゴン・サークル・ポリライン・マーカー）: 下の帯から足した場合・上の帯から足した場合とも、3D・2D で「ラスター < GroundImage < ポリゴン < サークル < ポリライン」の順になります。直す前は、上の帯から足すと 3D で GroundImage がラスターの下に潜り、うっすら透けるだけでした。
  • ラスター・ポリゴン・マーカー・ヒートマップのページは直す前と同じ見た目です。

web について

web（react-for-arcgis）はこの PR では変更していません。最新の develop で example（examples/basic、API キーは .env から vite 経由で読み込み）を Playwright で開き、ArcGIS 2D・3D とも、ラスターレイヤー（GSI の陰影起伏図）と GroundImage（University of Eswatini の画像が枠どおり）が表示されることを確かめました。

確認できていないもの・残った課題

• 重なり順の検証ページで、zIndex=1 のポリゴンを先に、zIndex=0 のポリゴンを後に足すと、Android の 3D・2D とも zIndex=1 が下になります（上の帯から足す順では正しい）。ポリゴンは GraphicsOverlay 側の問題で、この PR の変更とは関係しません。別に調べます。

関連 PR

• Put ground images on the 2D map too ios-for-arcgis#16（iOS: 2D の地図にも GroundImage を載せる）

それぞれ独立していて、マージの順番の制約はありません。