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

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

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

تحتوي مكتبة Maps Compose على دوال وأنواع بيانات قابلة للتجميع تتيح لك تنفيذ العديد من المهام الشائعة. تشمل بعض الدوال المكوّنة وأنواع البيانات الشائعة الاستخدام ما يلي:

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

للحصول على قائمة كاملة بجميع الدوال وأنواع البيانات القابلة للتجميع، يُرجى الاطّلاع على مرجع مكتبة Maps Compose.

المتطلبات

لاستخدام مكتبة Maps Compose مع حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" على Android، عليك إجراء ما يلي:

  • نزِّل ثبِّت الإصدار Arctic Fox من Android Studio.

  • أنشئ مشروعًا على "خرائط Google" في "استوديو Android" باستخدام:

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

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

  • ثبِّت مكتبة Maps Compose في المشروع كما هو موضّح في القسم التالي.

تثبيت

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

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

      dependencies {

    // Android Maps Compose composables for the Maps SDK for Android
    implementation("com.google.maps.android:maps-compose:6.2.1")
}

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

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

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

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

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

بعد ذلك، يستدعي المثال العنصر القابل للتجميع Marker في محتوى الخريطة لإضافة علامة إلى الخريطة.

لمقارنة هذا المثال بمثال يضيف خريطة باستخدام "المشاهدات"، اطّلِع على 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)
    }
  )
}

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