topic Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing in ArcGIS Maps SDK for Unity Questions

Migration Unity SDK 1.5 to 2.1 - basemap not showing

LukeMcBeath1 — Thu, 11 Sep 2025 15:12:28 GMT

I have a mobile project that is currently using v1.5 of the Unity SDK.

I am migrating to v2.1 but when I update the package the basemap is not displaying.

I am using the sat image basemap:

https://www.arcgis.com/home/item.html?id=c7d2b5c334364e8fb5b73b0f4d6a779b

The project is currently using a legacy API key but changing to a new rotating key has the same issue.

Other game objects on the map render fine.

Are there things that need to be done to the project/map/camera when migrating from 1.x to 2.x?

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

and1 — Thu, 11 Sep 2025 21:20:32 GMT

Hi LukeMcBeath1, the new API key and the legacy one should both work. How did you set up the basemap layer (through the Map Creator UI or through C#)? I tested the basemap you provided in 2.1, it works on my end.

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

LukeMcBeath1 — Thu, 11 Sep 2025 22:03:56 GMT

Map Creator UI

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

LukeMcBeath1 — Thu, 11 Sep 2025 22:11:00 GMT

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

and1 — Thu, 11 Sep 2025 23:20:10 GMT

Thanks for your screenshot. We have updated the Authentication workflow.

Under your Basemap section in your inspector (using SDK 2.1), you can change the Authentication dropdown option from "None" to "API Key". This should make the basemap display. It seems that you have manually change this dropdown option when you updated to 2.1.

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

LukeMcBeath1 — Fri, 12 Sep 2025 00:03:55 GMT

In the last screenshot I had reverted from 2.1 back to 1.5.

When using the 2.1 library the auth type is set to API Key

The scene viewer shows the basemap, but when I press play it just shows the brown unity ground

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

and1 — Fri, 12 Sep 2025 00:18:24 GMT

So the map renders in the editor view but not in the play mode? Can you check the camera position? Or you can try to go to the camera tab, and click "Align with View" so the camera will align with your current view in the editor, then hit "Play".

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

LukeMcBeath1 — Fri, 12 Sep 2025 03:18:43 GMT

We have a script that sets the camera location to look down on our "player"

The player objects render OK

public void UpdateCameraLocation()

{

if (arcGISCamera != null && lastLocation != null) {

var cameraLocation = arcGISCamera.GetComponent<ArcGISLocationComponent>();

cameraLocation.Position = lastLocation.ArcGISPointWithAltitude(cameraPosition.CameraAltitude(playerAltitude));

cameraLocation.Rotation = new ArcGISRotation(lastLocation.Heading, cameraPosition.Pitch, 0);

// logLocation("== UpdateCameraLocation", cameraLocation.GetComponent<ArcGISLocationComponent>());

}

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

and1 — Fri, 12 Sep 2025 18:13:19 GMT

Do you mind sharing a video clip so we could better see what's going with the map when you hit "Play"? Was the map showing before you hit the "Play" in Editor mode? Also did the camera code that you provided work for you in v1.5?

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

LukeMcBeath1 — Mon, 15 Sep 2025 18:09:39 GMT

https://youtu.be/4_foJB6G73I

PC is performing poorly after Windows 11 update 😞

Yes this code works with v1.5

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

and1 — Wed, 17 Sep 2025 17:37:04 GMT

Thanks for posting the video! I also tried upgrading a project from v1.5 to v2.1 and experienced the same issue. Let me do a bit of more investigations and get back to you. Thanks for your patience. Meanwhile, you could upgrade it to v2.0 for now (I tested that it's working on v2.0).

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

LukeMcBeath1 — Wed, 17 Sep 2025 23:28:14 GMT

Thank you for your ongoing support. Unfortunately I need the fix: "ArcGIS Maps SDK for Unity now supports Android devices and emulators that are configured to use a memory page size of 16 KB."

If I could have that fix in a 1.x release that would be great 🙂

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

jefferypickard — Sun, 21 Sep 2025 13:34:15 GMT

I had a similar issue when migrating—my basemap wouldn’t load until I adjusted the camera settings to fit the new SDK defaults. Also make sure your API key permissions cover basemap services. In my pak game project, clearing cached data and re-importing the package fixed the problem. The migration notes from 1.x to 2.x highlight some camera changes that are easy to miss.

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

LukeMcBeath1 — Mon, 22 Sep 2025 16:56:27 GMT

@jefferypickard - I have not found ANY migration notes other than info on the new authentication system.

Do you have any links to migration notes or camera settings that were helpful for you?

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

and1 — Thu, 25 Sep 2025 23:50:29 GMT

Hi @LukeMcBeath1 , It appears that the issue is not limited to the basemap; other types of layers (e.g. image layer, 3DObjectScene layer, etc.) in the scene are also failing to load after upgrading to v2.1 (while v2.0 worked). I reported this issue to the team for review and will share updates as soon as I get them. Thanks again for your patience.

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

and1 — Wed, 01 Oct 2025 21:20:49 GMT

Hi @LukeMcBeath1 , after upgrading a project from v1.5 to v2.1, the ArcGIS Camera component may appear disabled in the editor. You can manually enable it and re-save the scene, and it should then work correctly when entering play mode in v2.1.

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

LukeMcBeath1 — Fri, 03 Oct 2025 14:51:47 GMT

Thank you, that was the magic

Re: Migration Unity SDK 1.5 to 2.1 - basemap not showing

and1 — Thu, 19 Mar 2026 18:47:56 GMT

You're welcome. We also updated the release notes and add a section about upgrading to public doc so other users won't get confused.