Google Maps SDK — was ist das, Google Maps und API für die Entwicklung

Was ist Google Maps SDK?

Google Maps SDK ist eine umfassende Plattform für Entwickler, die Werkzeuge zur Arbeit mit geografischen Daten in Anwendungen bereitstellt. Die Plattform umfasst mehrere APIs: Maps SDK (Kartenanzeige), Routes API (Routen), Places API (Ortssuche und Geodaten) und Geocoding API (Adress-zu-Koordinaten-Konvertierung). Jedes SDK wird separat integriert und hat ein eigenes Abrechnungsmodell.

Im Gegensatz zu Apple MapKit bietet Google Maps SDK einen breiteren Datensatz: Informationen über 250 Millionen Orte, Echtzeit-Verkehr, Street View-Panoramen und Indoor Maps für Gebäude. Laut Statista (2025) hält Google Maps Platform 75% des Marktes für Kartierungs-SDKs in mobilen Anwendungen. Der Hauptvorteil ist ein einziger API-Schlüssel für alle Google Maps-Dienste und die plattformübergreifende Integration (Android, iOS, Web).

API-Schlüssel und Sicherheitseinrichtung

Der API-Schlüssel ist ein obligatorisches Element für die Arbeit mit Google Maps SDK. Der Schlüssel wird in der Google Cloud Console erstellt und an ein bestimmtes Projekt gebunden. Für Android muss das SHA-1-Zertifikat der App angegeben werden, für iOS die Bundle-ID. Google empfiehlt, die Nutzung des API-Schlüssels durch IP-Adressen, HTTP-Referrer oder App-Pakete einzuschränken, um unbefugten Zugriff zu verhindern.

Maps SDK für Android: Integration und Funktionen

Maps SDK für Android ist eine Bibliothek, die interaktive Google Maps über MapView oder SupportMapFragment in einer Android-App anzeigt. Das SDK unterstützt: benutzerdefinierte Kartenstile, Markierungen mit Infofenstern, Polygone und Polylinien, Verkehrs- und Transit-Ebenen sowie Touch-Ereignisse und Gesten (Zoom, Drehung, Neigung). Karten verwenden OpenGL zum Rendern und liefern 60 FPS auf modernen Geräten.

Die Integration beginnt mit dem Hinzufügen der Abhängigkeit in build.gradle und der Konfiguration des API-Schlüssels über AndroidManifest.xml. Google Maps SDK für Android erfordert Google Play Services auf dem Gerät. Wenn Google Play Services nicht verfügbar ist (z. B. auf Huawei-Geräten ohne Google-Dienste), werden Karten nicht angezeigt. Für solche Fälle empfiehlt Google alternative Lösungen oder WebView mit JavaScript Maps API.

// AndroidManifest.xml — Metadaten des API-Schlüssels
// 
//     android:value="YOUR_API_KEY"/>

// Kartenfragment in Activity
class MapActivity : AppCompatActivity(),
    OnMapReadyCallback {

    private lateinit var map: GoogleMap

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_map)
        val mapFragment = supportFragmentManager
            .findFragmentById(R.id.map) as SupportMapFragment
        mapFragment.getMapAsync(this)
    }

    override fun onMapReady(googleMap: GoogleMap) {
        map = googleMap
        val sydney = LatLng(-33.8688, 151.2093)
        map.addMarker(MarkerOptions().position(sydney)
            .title("Sydney"))
        map.moveCamera(CameraUpdateFactory
            .newLatLngZoom(sydney, 12f))
    }
}

Google Maps SDK auf Android unterstützt Indoor Maps — Anzeige von Gebäudegrundrissen (Flughäfen, Einkaufszentren). Einfach map.isIndoorEnabled = true setzen, um es zu aktivieren. Die Verkehrsebene zeigt Echtzeit-Verkehrsstaus — Daten werden alle 2-5 Minuten aktualisiert. Die Transitebene zeigt öffentliche Verkehrswege in unterstützten Städten an.

Maps SDK für iOS: Einrichtung und Verwendung

Maps SDK für iOS bietet die gleichen Funktionen wie die Android-Version, aber an die Apple-Plattform angepasst. Die Integration erfolgt über Swift Package Manager oder CocoaPods. Maps SDK für iOS verwendet Google-Server zum Rendern von Karten, kann aber für die native Navigation mit Apple MapKit zusammenarbeiten. Das SDK unterstützt iOS 15 und höher sowie SwiftUI über UIViewRepresentable.

Ein besonderes Merkmal der iOS-Version ist die obligatorische Konfiguration von Info.plist mit dem API-Schlüssel und das Hinzufügen des URL-Schemas für Google Maps. Im Gegensatz zu Android benötigt das iOS SDK keine Google Play Services, aber für einige Funktionen (z. B. Öffnen von Karten in der Navigation) ist die Google Maps App erforderlich. Für plattformübergreifende Projekte empfiehlt Google einen einzigen API-Schlüssel pro Projekt, der für beide Plattformen aktiviert ist.

import GoogleMaps

class MapViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        let camera = GMSCameraPosition.camera(
            withLatitude: 55.7558,
            longitude: 37.6173,
            zoom: 10
        )
        let mapView = GMSMapView.map(
            withFrame: view.frame,
            camera: camera
        )
        self.view = mapView

        let marker = GMSMarker()
        marker.position = CLLocationCoordinate2D(
            latitude: 55.7558,
            longitude: 37.6173
        )
        marker.title = "Moscow"
        marker.map = mapView
    }
}

Unter iOS unterstützt Google Maps SDK benutzerdefinierte Stile über eine JSON-Datei im Google Maps Styling-Format. Stile ermöglichen das Ändern der Farben von Straßen, Wasser, Parks und Gebäuden entsprechend dem App-Design. Ebenfalls unterstützt werden Heatmap Layer zur Visualisierung der Datendichte, KML und GeoJSON zum Importieren geografischer Daten aus externen Quellen.

Places API: Ortssuche und Geokodierung

Places API ist ein Dienst der Google Maps Platform zum Abrufen von Informationen über geografische Orte: Adressen, Koordinaten, Bewertungen, Öffnungszeiten, Fotos und Rezensionen. Die Places API arbeitet in zwei Modi: Place Search (Suche nach Text oder Radius) und Place Details (detaillierte Informationen zu einem bestimmten Ort über die Place-ID). Das SDK ist für Android, iOS und als REST API verfügbar.

Das Places SDK für Android und iOS ermöglicht das Einbetten der Adress-Autovervollständigung (Place Autocomplete) direkt in Textfelder der App. Dies ist eine Schlüsselfunktion für Liefer-, Taxi- und Logistik-Apps — der Benutzer beginnt mit der Eingabe einer Adresse und das SDK schlägt Optionen aus der Google Maps-Datenbank vor. Place Autocomplete reduziert Adresseingabefehler um 80% im Vergleich zur manuellen Eingabe. Abrechnung der Places API: $2.83 pro 1000 Place Details-Anfragen, Place Search — $4.71 pro 1000.

// Ortssuche nach Text auf Android
val placesClient = Places.createClient(context)
val request = FindCurrentPlaceRequest.builder(
    listOf(Place.Field.NAME, Place.Field.ADDRESS)
).build()

placesClient.findCurrentPlace(request)
    .addOnSuccessListener { response ->
        for (placeLikelihood in response.placeLikelihoods) {
            Log.d("Places", "${placeLikelihood.place.name} - ${placeLikelihood.likelihood}")
        }
    }

Place Autocomplete

Geocoding API — umgekehrte Geokodierung (Koordinaten zu Adresse) und direkte Geokodierung (Adresse zu Koordinaten). Wird verwendet, um eine vom Benutzer eingegebene Adresse in Koordinaten zur Anzeige auf der Karte umzuwandeln. Die Geocoding API wird separat abgerechnet: $4.71 pro 1000 Anfragen. Google stellt 200 kostenlose Anfragen pro Tag pro Konto zum Testen zur Verfügung.

Directions API: Routenberechnung

Directions API ist ein Dienst zur Berechnung von Routen zwischen zwei oder mehr Punkten unter Berücksichtigung des Verkehrsmittels (Auto, Fußgänger, Fahrrad, öffentliche Verkehrsmittel). Die API gibt mehrere alternative Routen mit Entfernung, Reisezeit, Schritt-für-Schritt-Anweisungen und einer Polylinie zum Zeichnen der Route auf der Karte zurück. Die Directions API ist als REST API und über Client-SDKs verfügbar.

Erweiterte Funktionalität — Routes API (neue API, von Google seit 2024 empfohlen). Die Routes API bietet verbessertes Routing mit Echtzeit-Verkehr, umweltfreundlichem Routing und prädiktiver Ankunftszeitanalyse. Laut Google berechnet die Routes API die Reisezeit in städtischen Umgebungen 20% genauer als die klassische Directions API. Die Routes API wird mit $5.00 pro 1000 Anfragen abgerechnet.

// Routenanfrage über Routes API
val client = OkHttpClient()
val requestBody = """
    {
        "origin": {"location": {"latLng": {"latitude": 55.75, "longitude": 37.61}}},
        "destination": {"location": {"latLng": {"latitude": 55.79, "longitude": 37.79}}},
        "travelMode": "DRIVE",
        "routingPreference": "TRAFFIC_AWARE"
    }
""".trimIndent()

val request = Request.Builder()
    .url("https://routes.googleapis.com/directions/v2:computeRoutes")
    .header("X-Goog-Api-Key", apiKey)
    .header("Content-Type", "application/json")
    .post(requestBody.toRequestBody())
    .build()

client.newCall(request).enqueue(object : Callback {
    override fun onResponse(call: Call, response: Response) {
        Log.d("Route", response.body?.string() ?: "")
    }
})

Directions API unterstützt bis zu 25 Zwischenziele (Waypoints) für eine einzelne Route. Waypoints können als Koordinaten oder Place-IDs angegeben werden. Um die Reihenfolge der Punkte zu optimieren (Problem des Handlungsreisenden), verwenden Sie den Parameter optimize:true. Preise: Directions API — $4.71 pro 1000 Anfragen (bis zu 10 Punkte), jeder zusätzliche Punkt erhöht die Anforderungskosten um 50%.

Kartenanpassung: Stile, Markierungen und Infofenster

Google Maps SDK bietet umfangreiche Anpassungsmöglichkeiten: Ändern des Kartenfarbschemas über JSON-Stile, Hinzufügen benutzerdefinierter Markierungen (einschließlich animierter), Infofenster (InfoWindow) mit benutzerdefiniertem Inhalt und Überlagern grafischer Ebenen (GroundOverlay, Circle, Polygon). Die Anpassung ermöglicht es, die Karte an die Marke der App anzupassen und die Benutzererfahrung zu verbessern.

Kartenstyling erfolgt über den Google Maps Styling Wizard oder eine JSON-Datei im Map Style-Format. Sie können die Farben von Straßen (featureType: road), Wasser (water), Parks (poi.park), Gebäuden (building) und anderen Elementen ändern. Für Karten in dunklen Apps verwenden Sie einen Nachtstil mit dunklem Hintergrund und gedämpften Farben. Google Maps unterstützt bis zu 100 Stilregeln in einer einzigen JSON-Datei.

Clustering für Leistung

Clustering — Zusammenfassen von Markierungen in Clustern bei einer großen Anzahl von Punkten auf der Karte. Google Maps SDK für Android und iOS enthält ein integriertes Clustering-Dienstprogramm (com.google.maps.android:android-maps-utils). Clustering verhindert die Überfüllung der Karte mit Markierungen bei niedrigen Zoomstufen. Beim Zoomen zerfällt der Cluster automatisch in einzelne Markierungen. Laut Google verbessert Clustering die Kartenleistung um 40% bei 1000+ Markierungen.

Codebeispiel: Karte mit Markierungen in Kotlin

Ein vollständiges Beispiel zur Anzeige einer Karte mit einer benutzerdefinierten Markierung, Routenpolylinie und einem Infofenster. Die App zeigt eine Karte von Moskau mit einem interessanten Punkt und einer Route dorthin vom Stadtzentrum aus. Der Code demonstriert die wichtigsten Funktionen des Google Maps SDK: Hinzufügen einer Markierung, Zeichnen einer Polylinie, Bewegen der Kamera und Behandeln von Klicks.

class MapDemoActivity : AppCompatActivity(), OnMapReadyCallback {

    override fun onMapReady(map: GoogleMap) {
        val kremlin = LatLng(55.7513, 37.6189)
        val gorkyPark = LatLng(55.7311, 37.6116)

        map.addMarker(MarkerOptions()
            .position(kremlin)
            .title("Kreml")
            .icon(BitmapDescriptorFactory.defaultMarker(
                BitmapDescriptorFactory.HUE_RED)))

        map.addPolyline(PolylineOptions()
            .add(kremlin, gorkyPark)
            .width(5f)
            .color(Color.parseColor("#2196F3")))

        map.moveCamera(CameraUpdateFactory
            .newLatLngZoom(kremlin, 13f))

        map.setOnInfoWindowClickListener { marker ->
            Toast.makeText(this,
                "${marker.title} clicked",
                Toast.LENGTH_SHORT).show()
        }
    }
}

Leistungsempfehlungen: Verwenden Sie asynchrones Laden von Markierungen über ClusterManager bei mehr als 200 Punkten, begrenzen Sie die Anzahl der sichtbaren Polylinien (Google empfiehlt nicht mehr als 100 gleichzeitig), verwenden Sie den Lite-Modus für Karten, die keine vollständige Funktionalität erfordern (Scrollen ohne Zoomänderungen). Der Lite-Modus reduziert den Speicherverbrauch um 50% und beschleunigt das Laden der Karte um das Zweifache.

Preise und Limits von Google Maps Platform

Google Maps Platform verwendet ein Pay-as-you-go-Modell mit einem monatlichen kostenlosen Limit von 200 $ Guthaben. Jede API wird separat abgerechnet: Maps SDK — 2,83 $ pro 1000 Kartenladungen, Places API — 4,71 $ pro 1000 Anfragen, Directions API — 4,71 $ pro 1000 Routen. Routes API (empfohlen) — 5,00 $ pro 1000 Anfragen. Das kostenlose Limit von 200 $ deckt in der Regel bis zu 70.000 Kartenladungen pro Monat ab.

Für stark frequentierte Projekte bietet Google Rabatte bei einem Volumen von 500.000+ Anfragen pro Monat. Google Maps SDK wird nicht für die Anzeige einer Basiskarte ohne Interaktion berechnet — die Gebühr fällt nur beim Laden der Karte an. Jedes Mal, wenn ein Benutzer einen Bildschirm mit einer Karte öffnet, zählt dies als ein Laden. Optimierung: Das Caching von Kartenkacheln reduziert die Anzahl der Ladevorgänge beim erneuten Öffnen.

Limits: 300 Anfragen pro Minute für die Places API (kann über das Kontingent in der Cloud Console auf 3000 erhöht werden). Für die Directions API — 100 Anfragen pro Minute. Bei Überschreitung des Limits wird der Fehler OVER_QUERY_LIMIT zurückgegeben. Google empfiehlt exponentielles Backoff für Wiederholungsanfragen. Die Überwachung der Nutzung ist in der Google Cloud Console mit einer Verzögerung von bis zu 5 Minuten verfügbar.