Azure Haritalar ile çalışmaya başlama Android SDK

Makale
11/04/2021
Okumak için 2 dakika

Azure Haritalar Android SDK, Android için bir vektör eşleme kitaplığıdır. bu makale, Azure Haritalar Android SDK yükleme ve eşleme yükleme işlemlerinde size rehberlik eder.

Önkoşullar

Hızlı başlangıç: Android uygulaması oluşturma makalesindeki adımları tamamladığınızdan emin olun.

Haritayı yerelleştirme

Azure Haritalar Android SDK haritanın dil ve bölgesel görünümünü ayarlamak için üç yol sağlar. Aşağıdaki kod, dilin Fransızca ("fr-FR") ve bölgesel görünümün "Auto" olarak nasıl ayarlanacağını gösterir.

AzureMapsStatik ve özellikleri kullanarak dili ve bölgesel görünüm bilgilerini sınıfa geçirin setLanguage setView . Bu işlem, uygulamanızda varsayılan dili ve bölgesel görünüm özelliklerini ayarlar.

static {
    //Alternatively use Azure Active Directory authenticate.
    AzureMaps.setAadProperties("<Your aad clientId>", "<Your aad AppId>", "<Your aad Tenant>");

    //Set your Azure Maps Key.
    //AzureMaps.setSubscriptionKey("<Your Azure Maps Key>");   

    //Set the language to be used by Azure Maps.
    AzureMaps.setLanguage("fr-FR");

    //Set the regional view to be used by Azure Maps.
    AzureMaps.setView("Auto");
}

companion object {
    init {
        //Alternatively use Azure Active Directory authenticate.
        AzureMaps.setAadProperties("<Your aad clientId>", "<Your aad AppId>", "<Your aad Tenant>");

        //Set your Azure Maps Key.
        //AzureMaps.setSubscriptionKey("<Your Azure Maps Key>");

        //Set the language to be used by Azure Maps.
        AzureMaps.setLanguage("fr-FR");

        //Set the regional view to be used by Azure Maps.
        AzureMaps.setView("Auto");
    }
}

Ayrıca, dil ve bölgesel görünüm bilgilerini harita denetimi XML 'e geçirebilirsiniz.

<com.azure.android.maps.control.MapControl
    android:id="@+id/myMap"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:azure_maps_language="fr-FR"
    app:azure_maps_view="Auto"
    />

Dil ve bölge görünümü özelliklerini programlı bir şekilde ayarlamanın son yolu Maps setStyle metodunu kullanır. Bu işlem, eşlemenin dil ve bölgesel görünümünü değiştirmek için herhangi bir zamanda yapılabilir.
```
mapControl.onReady(map -> {
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    );
});
```
```
mapControl.onReady(OnReady { map: AzureMap ->
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    )
})
```

aşağıda, dilin "fr-fr" olarak ayarlanan ve bölgesel görünümün "Auto" olarak ayarlandığı bir Azure Haritalar örneği verilmiştir.

Azure Haritalar, etiketleri fransızca olarak gösteren harita resmi

desteklenen dillerin ve bölgesel görünümlerin tamamı listesi için bkz. Azure Haritalar 'da yerelleştirme desteği.

Haritada gezinme

Haritanın Yakınlaştırılıp Yakınlaştırılıp döndürülmemiş, döndürülebileceği ve açık bir şekilde birçok farklı yolu vardır. Haritada gezinmek için kullanabileceğiniz farklı yollar aşağıda verilmiştir.

Haritayı Yakınlaştır

Parmakların ölçeğini yakınlaştırmak veya yaymak için iki parmağınızla ve Pinç ile Haritayı dokunarak bir araya geçirin.
Bir düzey yakınlaştırmak için haritaya çift dokunun.
Haritayı bir düzey büyütmek için iki parmağınızla çift dokunun.
İki kez dokunun; İkinci tap haritada parmak izi tutun ve yakınlaştırıp yakınlaştırmak için yukarı veya aşağı sürükleyin.

Haritayı kaydır

Haritayı dokunarak istediğiniz yönde sürükleyin.

Haritayı döndürme

İki parmağınızla haritaya dokunun ve döndürün.

Haritayı sıklık

İki parmağınızla Haritayı dokunarak yukarı veya aşağı sürükleyin.

Azure Kamu bulut desteği

azure Haritalar Android SDK azure kamu bulutunu destekler. Azure Haritalar Android SDK aynı maven deposundan erişilir. azure Haritalar platformunun azure kamu bulut sürümüne bağlanmak için aşağıdaki görevlerin yapılması gerekir.

azure Haritalar kimlik doğrulama ayrıntılarının belirtildiği aynı yerde, eşlemenin azure Haritalar kamu bulut etki alanını kullanmasını söylemek için aşağıdaki kod satırını ekleyin.

AzureMaps.setDomain("atlas.azure.us");

AzureMaps.setDomain("atlas.azure.us")

harita ve hizmetlerin kimliğini doğrularken azure kamu bulut platformunda azure Haritalar kimlik doğrulaması ayrıntılarını kullandığınızdan emin olun.

Önizleme sürümünden geçiş

önizlemeden genel kullanılabilirliğe taşıma ile Azure Haritalar Android SDK bazı önemli değişiklikler yapılmıştır. Aşağıdakiler, önemli ayrıntılardır:

Maven tanımlayıcısı iken olarak değiştirildi "com.microsoft.azure.maps:mapcontrol:0.7" "com.azure.android:azure-maps-control:1.0.0" . Ad alanı ve ana sürüm numarası değişti.
İçeri aktarma ad alanı olarak değiştirildi com.microsoft.azure.maps.mapcontrol``com.azure.android.maps.control

XML seçenekleri, renk kaynakları ve resim kaynakları için kaynak adlarında metin mapcontrol_ değiştirilmiştir azure_maps_ .

Eklenmeden

<com.microsoft.azure.maps.mapcontrol.MapControl
    android:id="@+id/myMap"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:mapcontrol_language="fr-FR"
    app:mapcontrol_view="Auto"
    app:mapcontrol_centerLat="47.602806"
    app:mapcontrol_centerLng="-122.329330"
    app:mapcontrol_zoom="12"
/>

Sonra

<com.azure.android.maps.control.MapControl
    android:id="@+id/myMap"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:azure_maps_language="fr-FR"
    app:azure_maps_view="Auto"
    app:azure_maps_centerLat="47.602806"
    app:azure_maps_centerLng="-122.329330"
    app:azure_maps_zoom="12"
/>