הצגת מפה בסיסית

בדוגמה הזו נוצרת מפה באמצעות SupportMapFragment SDK של מפות ל-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 כדי להריץ את הדוגמה הזו באופן מקומי. הפקודה הבאה תשכפל את הדוגמה של Google Apps.

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

מייבאים את הפרויקט לדוגמה אל Android Studio:

1. ב-Android Studio, בוחרים באפשרות File > חדש > ייבוא פרויקט.

2. עוברים למיקום שבו שמרתם את המאגר ובוחרים את ספריית הפרויקט. Kotlin או Java:

   • Kotlin: PATH-REPO/android-samples/ApiDemos/kotlin
   • Java: PATH-REPO/android-samples/ApiDemos/java
3. לוחצים על פתיחה. מערכת Android Studio יוצרת את הפרויקט באמצעות גרסת ה-build של Gradle של Google.
4. יוצרים קובץ secrets.properties ריק באותה ספרייה שבה נמצא קובץ local.properties של הפרויקט. מידע נוסף זמין במאמר הוספת מפתח API לפרויקט.

5. מוסיפים את המחרוזת הבאה אל secrets.properties, ומחליפים את YOUR_API_KEY בערך של מפתח ה-API:

   MAPS_API_KEY=YOUR_API_KEY

6. מפעילים את האפליקציה.