بدء استخدام Azure Maps Android SDK

مقالة
04/07/2024

خرائط Azure Android SDK هي مكتبة خريطة متجهات لنظام Android. ترشدك المقالة خلال عمليات تثبيت خرائط Azure Android SDK وتحميل خريطة.

إشعار

خرائط Azure إيقاف Android SDK

تم الآن إهمال خرائط Azure Native SDK لنظام التشغيل Android وسيتم إيقافه في 3/31/25. لتجنب انقطاع الخدمة، قم بالترحيل إلى خرائط Azure Web SDK بحلول 3/31/25. لمزيد من المعلومات، راجع دليل ترحيل خرائط Azure Android SDK.

المتطلبات الأساسية

التأكد من إكمال الخطوات الواردة في مستند التشغيل السريع: إنشاء تطبيق Android.

ترجمة الخريطة

يوفر برنامج خرائط Azure الخاص بـ Android SDK ثلاث طرق لتعيين اللغة وعرض الخريطة على المستوى الإقليمي. توضح التعليمات البرمجية التالية كيفية تعيين اللغة إلى الفرنسية ("fr-FR") وطريقة العرض الإقليمية إلى "Auto".

مرر معلومات اللغة والعرض الإقليمي إلى الفئة AzureMaps باستخدام الخصائص setLanguage وsetView الثابتة. هذا يعيّن اللغة الافتراضية وخصائص العرض الإقليمية في تطبيقك.

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");
    }
}

يمكنك أيضا التمرير لمعلومات اللغة والعرض الإقليمي إلى XML عنصر تحكم الخريطة.

<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"
    />

الطريقة النهائية برمجيا تعيين خصائص اللغة وطريقة العرض الإقليمية يستخدم أسلوب setStyle للخرائط. يمكن القيام بذلك في أي وقت لتغيير اللغة وطريقة العرض الإقليمية للخريطة.
```
mapControl.onReady(map -> {
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    );
});
```
```
mapControl.onReady(OnReady { map: AzureMap ->
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    )
})
```

فيما يلي مثال على خرائط Azure مع تعيين اللغة إلى "fr-FR" وطريقة العرض الإقليمية إلى "تلقائي".

خرائط Azure، صورة خريطة تعرض التسميات باللغة الفرنسية

للحصول على قائمة كاملة باللغات المعتمدة وطرق العرض الإقليمية، ارجع إلى دعم التعريب في خرائط Azure.

التنقل في الخريطة

توجد عدة طرق مختلفة يمكن من خلالها تكبير الخريطة وتحريكها وتدويرها وتصغيرها. توضح التفاصيل التالية جميع الطرق المختلفة للتنقل على الخريطة.

كبر الخريطة

المس الخريطة بأصبعين وقربهما من بعضهما للتصغير أو باعدهما للتكبير.
اضغط ضغطًا مزدوجًا فوق الخريطة للتكبير مستوى واحد.
اضغط ضغطا مزدوجا بأصبعين لتصغير الخريطة بمستوى واحد.
اضغط مرتين؛ عند النقرة الثانية، اضغط بإصبعك على الخريطة واسحب لأعلى للتكبير أو لأسفل للتصغير.

تحريك الخريطة

المس الخريطة واسحب في أي اتجاه.

تدوير الخريطة

المس الخريطة بإصبعين وقم بالتدوير.

عرض الخريطة

المس الخريطة بأصبعين واسحبهما لأعلى أو لأسفل معا.

دعم Azure Government cloud

تدعم خرائط Azure الخاصة بـ Android SDK سحابة Azure Government. الوصول إلى خرائط Azure الخاصة بـ Android SDK من نفس مستودع Maven. يجب القيام بالمهام التالية للاتصال بإصدار سحابة Azure Government من النظام الأساسي خرائط Azure.

في نفس المكان الذي يتم فيه تحديد تفاصيل مصادقة Azure الخرائط، أضف السطر التالي من التعليمات البرمجية لإخبار الخريطة باستخدام المجال السحابي الحكومي Azure الخرائط.

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

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

تأكد من استخدام تفاصيل المصادقة لخرائط Azure من النظام الأساسي السحابي Microsoft Azure Government عند مصادقة الخريطة والخدمات.

الترحيل من إصدار المعاينة

مع الانتقال من المعاينة إلى التوفر العام، تم إدخال بعض التغييرات العاجلة في خرائط Azure Android SDK. فيما يلي التفاصيل الأساسية:

تغيير معرف maven من "com.microsoft.azure.maps:mapcontrol:0.7" إلى "com.azure.android:azure-maps-control:1.0.0". تم تغيير مساحة الاسم ورقم الإصدار الرئيسي.
تغيرت مساحة اسم الاستيراد من com.microsoft.azure.maps.mapcontrol إلى com.azure.android.maps.control

تحتوي أسماء الموارد لخيارات XML وموارد الألوان وموارد الصور على النص mapcontrol_ وقد تم استبداله بالنص azure_maps_.

قبل:

<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"
/>

بعد:

<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"
/>