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

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

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

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

שנתחיל?

לפני שתוכלו לנסות את הקוד לדוגמה, עליכם להגדיר את סביבת הפיתוח. מידע נוסף זמין במאמר דוגמאות קוד ל-SDK של מפות ל-Android.

הצגת הקוד

KotlinJava
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 SamplesBaseActivity 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);
        applyInsets(findViewById(R.id.map_container));
    }

    /**
     * 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. הפקודה הבאה יוצרת עותק (clone) של מאגר האפליקציה לדוגמה.

git clone git@github.com:googlemaps-samples/android-samples.git

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

  1. ב-Android Studio, בוחרים באפשרות File (קובץ) > New (חדש) > Import Project (ייבוא פרויקט).

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

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

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

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