Wyświetlanie mapy podstawowej

W tym przykładzie tworzona jest mapa przy użyciu SupportMapFragment z pakietu Maps SDK na Androida.

Więcej informacji znajdziesz w artykule Dodawanie mapy do aplikacji na Androida.

Rozpocznij

Zanim wypróbujesz przykładowy kod, musisz skonfigurować środowisko programistyczne. Więcej informacji znajdziesz w przykładowym kodzie pakietu Maps SDK na Androida.

Wyświetlanie kodu

Kotlin

class BasicMapDemoActivity :
    SamplesBaseActivity(),
    OnMapReadyCallback {

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

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.basic_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).title("Sydney"))
        }
    }
}

      

Java

public class BasicMapDemoActivity extends SamplesBaseActivity implements OnMapReadyCallback {

    private static final LatLng SYDNEY = new LatLng(-33.862, 151.21);
    private static final float ZOOM_LEVEL = 13.0f;

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

        SupportMapFragment mapFragment =
                (SupportMapFragment)
                        getSupportFragmentManager()
                                .findFragmentById(com.example.common_ui.R.id.map);
        mapFragment.getMapAsync(this);
        applyInsets(findViewById(com.example.common_ui.R.id.map_container));
    }

    /**
     * This is where we can add markers or lines, add listeners or move the camera. In this case, we
     * move the camera to Sydney and add a marker at Sydney.
     */
    @Override
    public void onMapReady(GoogleMap map) {
        map.moveCamera(CameraUpdateFactory.newLatLngZoom(SYDNEY, ZOOM_LEVEL));
        map.addMarker(new MarkerOptions().position(SYDNEY).title("Sydney"));
    }
}

      

Klonowanie i uruchamianie przykładów

Do uruchomienia tego przykładu lokalnie wymagany jest Git. To polecenie klonuje repozytorium przykładowej aplikacji.

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

Zaimportuj przykładowy projekt do Android Studio:

1. W Android Studio kliknij File > New > Import Project (Plik > Nowy > Importuj projekt).

2. Otwórz lokalizację, w której zapisano repozytorium, i wybierz katalog projektu dla Kotlina lub Javy:

   • Kotlin PATH-REPO/android-samples/ApiDemos/kotlin
   • Java: PATH-REPO/android-samples/ApiDemos/java
3. Wybierz Otwórz. Android Studio kompiluje projekt za pomocą narzędzia Gradle.
4. Utwórz pusty plik secrets.properties w tym samym katalogu co plik local.properties projektu. Więcej informacji o tym pliku znajdziesz w sekcji Dodawanie klucza interfejsu API do projektu.
5. Pobierz klucz interfejsu API z projektu z włączonym pakietem Maps SDK na Androida.

6. Dodaj do pliku secrets.properties ten ciąg znaków, zastępując YOUR_API_KEY wartością klucza interfejsu API:

   MAPS_API_KEY=YOUR_API_KEY

7. Uruchom aplikację.