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

תמונה של 'הצגת מפה בסיסית'.

בדוגמה הזו נוצרת מפה באמצעות SupportMapFragment מה-SDK של מפות Google ל-Android.

מידע נוסף זמין במסמכי התיעוד.

תחילת העבודה

כדי שתוכלו לנסות את הקוד לדוגמה, עליכם להגדיר את סביבת הפיתוח. מידע נוסף זמין במאמר SDK של מפות 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 Studio:

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

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

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

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

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