Introdução ao SDK dos Azure Mapas para iOS (versão prévia)

Artigo
04/10/2024

O SDK do iOS do Azure Mapas é uma biblioteca de mapas vetoriais para iOS. Este artigo orienta você pelos processos de instalação do SDK do iOS do Azure Mapas e de carregamento de um mapa.

Observação

Desativação do SDK do iOS no Azure Mapas

O SDK Nativo do Azure Mapas para iOS já foi preterido e será desativado em 31/03/25. Para evitar interrupções de serviço, migre para o SDK da Web do Azure Mapas até 31/03/25. Para obter mais informações, confira O guia de migração do SDK do iOS no Azure Mapas.

Pré-requisitos

Conclua as etapas do artigo Guia de Início Rápido: Criar um aplicativo iOS.

Como localizar o mapa

O SDK do iOS do Azure Mapas fornece três maneiras de definir o idioma e a exibição regional do mapa. O código a seguir demostra as diferentes maneiras de definir o idioma como francês (fr-FR) e a exibição regional como Auto.

Defina o idioma padrão e as propriedades de exibição regional em seu aplicativo passando as informações de idioma e exibição regional para a classe AzureMaps usando as propriedades estáticas language e view.

// Alternatively use Azure Active Directory authenticate.
AzureMaps.configure(aadClient: "<Your aad clientId>", aadAppId: "<Your aad AppId>", aadTenant: "<Your aad Tenant>")

// Set your Azure Maps Key.
// AzureMaps.configure(subscriptionKey: "<Your Azure Maps Key>")

// Set the language to be used by Azure Maps.
AzureMaps.language = "fr-FR"

// Set the regional view to be used by Azure Maps.
AzureMaps.view = "Auto"

Você também pode passar as informações do idioma e da exibição regional para a inicialização do controle de mapa.
```
MapControl(options: [
    StyleOption.language("fr-FR"),
    StyleOption.view("Auto")
])
```
A maneira final de definir programaticamente as propriedades de idioma e de exibição regional usa o método setStyle dos mapas. Use o método setStyle de mapas a qualquer momento que você precisar alterar o idioma e a exibição regional do mapa.
```
mapControl.getMapAsync { map in
    map.setStyleOptions([
        StyleOption.language("fr-FR"),
        StyleOption.view("Auto")
    ])
}
```

Aqui está um exemplo de um aplicativo do Azure Mapas com o idioma definido como fr-FR e a exibição regional definida como Auto.

Imagem de um mapa mostrando rótulos em francês.

Para ver a lista completa de idiomas e exibições regionais com suporte, consulte Suporte à localização no Azure Mapas.

Navegar no mapa

Esta seção detalha as várias maneiras de navegar em um programa do Azure Mapas.

Ampliar o mapa

Toque no mapa com dois dedos e junte-os para reduzir, ou afaste-os para ampliar.
Toque duas vezes no mapa para ampliar um nível.
Toque duas vezes com dois dedos para reduzir o mapa um nível.
Toque duas vezes. No segundo toque, mantenha seu dedo no mapa e arraste para cima para ampliar ou para baixo para reduzir.

Deslocar o mapa

Toque no mapa e arraste em qualquer direção.

Girar o mapa

Toque no mapa com dois dedos e gire.

Inclinar o mapa

Toque no mapa com dois dedos e arraste-os para cima ou para baixo juntos.

Suporte da nuvem do Azure Governamental

O SDK do iOS do Azure Mapas dá suporte ao uso da nuvem do Azure Governamental. Você especifica o uso do domínio de nuvem governamental do Azure Mapas adicionando a seguinte linha de código, na qual os detalhes de autenticação do Azure Mapas são especificados:

AzureMaps.domain = "atlas.azure.us"

Use os detalhes de autenticação dos Azure Mapas da plataforma de nuvem do Azure Governamental ao autenticar o mapa e os serviços.

Informações adicionais

Confira os seguintes artigos para obter exemplos de código completo:

Compartilhar via