How to use Terra maps (MapTile.GetTerraTile and layer=terra) in azure map.

Question

How to use Terra maps (MapTile.GetTerraTile and layer=terra) in azure map.

Smit Khanpara 0

In React
How to add Terra maps (MapTile.GetTerraTile and layer=terra) in azure map.

LeelaRajeshSayana-MSFT 17,521 Reputation points

2023-10-25T22:27:40.2933333+00:00

Hi @Smit Khanpara Greetings! I am following up to see if you got a chance to review the below response. Please let us know if you have any additional questions or need further assistance.

If the response helped, please do click Accept Answer and Yes for the answer provided. Doing so would help other community members with similar issue identify the solution. I highly appreciate your contribution to the community.

1 answer

Your answer

LeelaRajeshSayana-MSFT 17,521 Reputation points

2023-10-25T22:27:40.2933333+00:00

Hi @Smit Khanpara Greetings! I am following up to see if you got a chance to review the below response. Please let us know if you have any additional questions or need further assistance.

If the response helped, please do click Accept Answer and Yes for the answer provided. Doing so would help other community members with similar issue identify the solution. I highly appreciate your contribution to the community.

Answer 1

rbrundritt 20,181 Microsoft Employee

I haven't seen GetTerraTile in any docs for any Azure Maps API or SDK. You mention React, so I would assume you are using the Azure Maps React library here: https://github.com/Azure/react-azure-maps Looking through the source code, I still don't any such method name.

In the Web SDK of Azure Maps, the Terra map tiles are a part of the road_shaded_relief map style.

Assuming you are using that react library and you want to see the terra layer, here is how you can do that based on this example: https://github.com/Azure/react-azure-maps-playground/blob/master/src/examples/Options/ChangeOptions.tsx

  const option: IAzureMapOptions = useMemo(() => {
    return {
      authOptions: {
        authType: AuthenticationType.subscriptionKey,
        subscriptionKey: key,
      },
      center: [-100.01, 45.01],
      zoom: 10,
      view: 'Auto',
      style: 'road_shaded_relief'
    };
  }, []);

Sujal Shah - Housing India 80 Reputation points

2023-10-23T06:07:02.2866667+00:00

@rbrundritt I am looking for the same
Here is the doc I found regarding this: https://learn.microsoft.com/en-us/azure/azure-maps/understanding-azure-maps-transactions

I found out the terra layer is nonbillable and want to use it in my project to reduce the transaction cost.
Is road_shaded_relief style is the only way to switch to the terra layer?
Sujal Shah - Housing India 80 Reputation points

2023-10-23T06:16:11.06+00:00
The library I'm using is

'azure-maps-control'

rbrundritt 20,181 Microsoft Employee

The Terra layer has no labels, is pretty basic and is non-billable as it is used as a background layer to the road shaded relief layer. I'm not sure if it's non-billable when used directly. It's also only available to zoom level 6 (country level). To use it on its own, you need to add it as a tile layer. Here is some code:

var map;

function GetMap() {
	//Initialize a map instance.
	map = new atlas.Map('myMap', {
		style:'blank', //Setting the map style to blank so that it doesn't load any billable tiles.
		view: 'Auto',

		authOptions: {
			authType: 'subscriptionKey',
			subscriptionKey: '<Your Azure Maps Key>'
		}
	});

	//Wait until the map resources are ready.
	map.events.add('ready', function () {
		//Create a tile layer and add it to the map.
		map.layers.add(new atlas.layer.TileLayer({
			tileUrl: 'https://{azMapsDomain}/map/tile/png?api-version=1.0&layer=terra&style=shaded_relief&zoom={z}&x={x}&y={y}',
			tileSize: 512,
			minSourceZoom: 0,
			maxSourceZoom: 6
		}));
	});
}

Share via

How to use Terra maps (MapTile.GetTerraTile and layer=terra) in azure map.

1 answer

Your answer