عرض خريطة أساسية

ينشئ هذا المثال خريطة باستخدام SupportMapFragment من حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android.

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إضافة خريطة إلى تطبيق Android.

البدء

قبل تجربة الرمز النموذجي، عليك ضبط بيئة التطوير. لمزيد من المعلومات، يُرجى الاطّلاع على عيّنات التعليمات البرمجية في حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android.

عرض الرمز

Kotlin

class BasicMapDemoActivity :
    SamplesBaseActivity(),
    OnMapReadyCallback {

    val SYDNEY = LatLng(-33.862, 151.21)
    val ZOOM_LEVEL = 13f

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.basic_demo)
        val mapFragment: SupportMapFragment? =
            supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
        mapFragment?.getMapAsync(this)
    }

    /**
     * This is where we can add markers or lines, add listeners or move the camera. In this case,
     * we just move the camera to Sydney and add a marker in Sydney.
     */
    override fun onMapReady(googleMap: GoogleMap) {
        with(googleMap) {
            moveCamera(CameraUpdateFactory.newLatLngZoom(SYDNEY, ZOOM_LEVEL))
            addMarker(MarkerOptions().position(SYDNEY).title("Sydney"))
        }
    }
}

      

جافا

public class BasicMapDemoActivity extends SamplesBaseActivity implements OnMapReadyCallback {

    private static final LatLng SYDNEY = new LatLng(-33.862, 151.21);
    private static final float ZOOM_LEVEL = 13.0f;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(com.example.common_ui.R.layout.basic_demo);

        SupportMapFragment mapFragment =
                (SupportMapFragment)
                        getSupportFragmentManager()
                                .findFragmentById(com.example.common_ui.R.id.map);
        mapFragment.getMapAsync(this);
        applyInsets(findViewById(com.example.common_ui.R.id.map_container));
    }

    /**
     * This is where we can add markers or lines, add listeners or move the camera. In this case, we
     * move the camera to Sydney and add a marker at Sydney.
     */
    @Override
    public void onMapReady(GoogleMap map) {
        map.moveCamera(CameraUpdateFactory.newLatLngZoom(SYDNEY, ZOOM_LEVEL));
        map.addMarker(new MarkerOptions().position(SYDNEY).title("Sydney"));
    }
}

      

استنساخ النماذج وتشغيلها

يجب استخدام Git لتشغيل هذا النموذج محليًا. ينسخ الأمر التالي مستودع التطبيق النموذجي.

git clone [e-mail]:googlemaps-samples/android-samples.git

استورِد نموذج المشروع إلى "استوديو Android":

1. في "استوديو Android"، انقر على ملف > جديد > استيراد مشروع.

2. انتقِل إلى الموقع الذي حفظت فيه المستودع واختَر دليل المشروع للغة Kotlin أو Java:

   • Kotlin: PATH-REPO/android-samples/ApiDemos/kotlin
   • ‫Java: PATH-REPO/android-samples/ApiDemos/java
3. اختيار فتح ينشئ "استوديو Android" مشروعك باستخدام أداة الإصدار Gradle.
4. أنشئ ملف secrets.properties فارغًا في الدليل نفسه الذي يحتوي على ملف local.properties الخاص بمشروعك. لمزيد من المعلومات حول هذا الملف، يُرجى الاطّلاع على إضافة مفتاح واجهة برمجة التطبيقات إلى المشروع.
5. احصل على مفتاح واجهة برمجة تطبيقات من مشروعك مع تفعيل حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android.

6. أضِف السلسلة التالية إلى secrets.properties، مع استبدال YOUR_API_KEY بقيمة مفتاح واجهة برمجة التطبيقات:

   MAPS_API_KEY=YOUR_API_KEY

7. شغِّل التطبيق.