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

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

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

بدء

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

عرض الرمز

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

      

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. شغِّل التطبيق.