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

صورة تعرض خريطة أساسية

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

لمزيد من المعلومات، يُرجى الاطّلاع على المستندات.

البدء

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

عرض الرمز

Kotlin



class BasicMapDemoActivity : AppCompatActivity(), OnMapReadyCallback {

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

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_basic_map_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))
        }
    }
}
BasicMapDemoActivity.kt

Java


public class BasicMapDemoActivity extends AppCompatActivity implements OnMapReadyCallback {

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

        SupportMapFragment mapFragment =
                (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    /**
     * This is where we can add markers or lines, add listeners or move the camera. In this case,
     * we
     * just add a marker near Africa.
     */
    @Override
    public void onMapReady(GoogleMap map) {
        map.addMarker(new MarkerOptions().position(new LatLng(0, 0)).title("Marker"));
    }
}
BasicMapDemoActivity.java

استنساخ العينات وتشغيلها

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

git clone git@github.com: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. أضف السلسلة التالية إلى secrets.properties، مع استبدال YOUR_API_KEY بقيمة مفتاح واجهة برمجة التطبيقات:

    MAPS_API_KEY=YOUR_API_KEY
  6. شغِّل التطبيق.