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

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

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

تحتوي مكتبة Maps Compose على دوال قابلة للإنشاء وأنواع بيانات تتيح تؤدي العديد من المهام الشائعة. بعض الدوال الشائعة الاستخدام للإنشاء وأنواع البيانات ما يلي:

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

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

المتطلبات

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

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

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

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

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

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

تثبيت

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

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

      dependencies {


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

  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 السمات ذات الصلة بواجهة المستخدم يمكنك تعديل هذه الكائنات لإعادة تركيب الخريطة.

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

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

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