مكتبة "الكتابة في الخرائط"

Jetpack Compose عبارة عن مجموعة أدوات تعريفية ومحلية لواجهة المستخدم تعمل على تبسيط عملية تطوير واجهة المستخدم وتسريعها. باستخدام Jetpack Compose، يمكنك وصف الشكل الذي تريد أن يظهر به تطبيقك، ثم السماح لـ Jetpack Compose بمعالجة الباقي.

إنّ مكتبة "الكتابة في خرائط Google" لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android هي مجموعة من الدوال وأنواع البيانات المفتوحة المصدر التي يمكنك استخدامها مع Jetpack Compose لإنشاء تطبيقك.

تحتوي مكتبة "إنشاء الخرائط" على دوال وأنواع بيانات قابلة للإنشاء تتيح لك تنفيذ العديد من المهام الشائعة. تتضمن بعض الدوال وأنواع البيانات القابلة للإنشاء الشائعة ما يلي:

قابلة للإنشاء الوصف
دائرة دالة قابلة للإنشاء لإضافة دائرة إلى خريطة.
GoogleMap دالة قابلة للإنشاء لإضافة خريطة
GroundOverlay دالة قابلة للإنشاء لإضافة تراكب أرض إلى خريطة
MapProperties نوع البيانات للمواقع التي يمكن تعديلها على خريطة.
MapUISettings نوع البيانات للإعدادات المتعلقة بواجهة المستخدم على خريطة
محدِّد الموقع دالة قابلة للإنشاء لإضافة علامة إلى خريطة.
المضلّع دالة قابلة للإنشاء لإضافة مضلّع إلى خريطة
خطوط متعددة دالة قابلة للإنشاء لإضافة خطوط متعددة إلى خريطة.
TileOverlay دالة قابلة للإنشاء لإضافة تراكب مربّعات إلى خريطة.

للحصول على قائمة كاملة بجميع الدوال وأنواع البيانات القابلة للإنشاء، يمكنك الاطّلاع على مرجع مكتبة "الكتابة في خرائط Google".

المتطلّبات

لاستخدام مكتبة "إنشاء الخرائط في خرائط Google" مع حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android، يجب عليك:

  • نزِّل وثبِّت Android Studio Arctic Fox.

  • يمكنك إنشاء مشروع "خرائط Google" في "استوديو Android" باستخدام:

    • نوع نموذج نشاط الإنشاء الفارغ. يضيف هذا النموذج التبعيات الضرورية التي يتطلبها Jetpack Compose.
    • تم ضبط الحد الأدنى لحزمة تطوير البرامج (SDK) على واجهة برمجة التطبيقات 21: Android 5.0 (Lollipop) أو إصدار أحدث.
    • تم ضبط اللغة على Kotlin.

  • يجب الحصول على مفتاح واجهة برمجة التطبيقات وإضافته إلى مشروعك.

  • ثبِّت مكتبة "إنشاء الخرائط" في المشروع كما هو موضَّح في القسم التالي.

تثبيت

لتثبيت مكتبة "الكتابة في خرائط Google" في مشروعك على "خرائط Google":

  1. أضِف التبعيات التالية إلى ملف build.gradle على مستوى الوحدة:

      dependencies {


    // Android Maps Compose composables for the Maps SDK for Android
    implementation 'com.google.maps.android:maps-compose:4.3.3'
}

  2. يجب إعادة إنشاء مشروعك في "استوديو Android" لمزامنة هذه التغييرات.

إضافة خريطة إلى تطبيقك

يوضح المثال التالي كيفية استخدام عنصر GoogleMap القابل للإنشاء لإضافة خريطة. 

val singapore = LatLng(1.35, 103.87)
val cameraPositionState = rememberCameraPositionState {
  position = CameraPosition.fromLatLngZoom(singapore, 10f)
}
GoogleMap(
  modifier = Modifier.fillMaxSize(),
  cameraPositionState = cameraPositionState
) {
  Marker(
    state = MarkerState(position = singapore),
    title = "Singapore",
    snippet = "Marker in Singapore"
  )
}

في هذا المثال، تشغل الخريطة الحد الأقصى المسموح به وتتمحور الكاميرا حول سنغافورة. يتم أيضًا إنشاء CameraPositionState وتقديمه في cameraPositionState لضبط موضع الكاميرا.

يستدعي المثال بعد ذلك علامة الإنشاء في محتوى الخريطة لإضافة علامة إلى الخريطة.

لمقارنة هذا المثال بمثال يضيف خريطة باستخدام طرق العرض، راجع QuickStart. لاحظ كيف تتطلب الدوال القابلة للإنشاء تعليمات برمجية أقل، ولا تقلق بشأن دورة حياة الخريطة.

تحديد المواقع على خريطة

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

في المثال أدناه، استخدِم مفتاح تبديل، وهو أحد مكوّنات التصميم المتعدد الأبعاد، لتبديل عناصر التحكّم في التكبير أو التصغير على الخريطة.

var uiSettings by remember { mutableStateOf(MapUiSettings()) }
var properties by remember {
  mutableStateOf(MapProperties(mapType = MapType.SATELLITE))
}

Box(Modifier.fillMaxSize()) {
  GoogleMap(
    modifier = Modifier.matchParentSize(),
    properties = properties,
    uiSettings = uiSettings
  )
  Switch(
    checked = uiSettings.zoomControlsEnabled,
    onCheckedChange = {
      uiSettings = uiSettings.copy(zoomControlsEnabled = it)
    }
  )
}

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