Google Maps SDK — ano ito, Google Maps at API para sa pag-develop

Ano ang Google Maps SDK?

Google Maps SDK — ay isang komprehensibong platform para sa mga developer na nagbibigay ng mga tool para sa pagtatrabaho sa heyograpikong data sa mga application. Kasama sa platform ang ilang API: Maps SDK (pagpapakita ng mapa), Routes API (ruta), Places API (paghahanap ng lugar at geodata), at Geocoding API (pag-convert ng address sa coordinate). Bawat SDK ay isinasama nang hiwalay at may sariling modelo ng pagbabayad.

Hindi tulad ng Apple MapKit, ang Google Maps SDK ay nag-aalok ng mas malawak na set ng data: impormasyon tungkol sa 250 milyong lugar, real-time na trapiko, Street View panorama, at Indoor Maps para sa mga panloob na espasyo. Ayon sa Statista (2025), ang Google Maps Platform ay may hawak na 75% ng merkado ng mapping SDK sa mobile application. Ang pangunahing bentahe — iisang API key para sa lahat ng serbisyo ng Google Maps at cross-platform integration (Android, iOS, web).

API key at configuration ng seguridad

API key — sapilitang elemento para sa pagtatrabaho sa Google Maps SDK. Ang key ay ginagawa sa Google Cloud Console at naka-link sa partikular na proyekto. Para sa Android, kailangan ang SHA-1 ng certificate ng application, para sa iOS — Bundle Identifier. Inirerekomenda ng Google na limitahan ang paggamit ng API key batay sa IP address, HTTP referrer, o package ng application upang maiwasan ang hindi awtorisadong pag-access.

Maps SDK para sa Android: integrasyon at mga kakayahan

Maps SDK para sa Android — ay isang library na nagpapakita ng interactive na Google Maps sa loob ng Android application sa pamamagitan ng MapView o SupportMapFragment. Sinusuportahan ng SDK ang: custom na estilo ng mapa, marker na may impormasyon window, polygon at polyline, layer ng trapiko at transportasyon, pati na rin ang touch event at gestures (zoom, rotate, tilt). Gumagamit ang mga mapa ng OpenGL para sa rendering, na nagbibigay ng 60 FPS sa modernong device.

Ang integrasyon ay nagsisimula sa pagdaragdag ng dependency sa build.gradle at pag-configure ng API key sa pamamagitan ng AndroidManifest.xml. Google Maps SDK para sa Android ay nangangailangan ng Google Play Services sa device. Kung wala ang Google Play Services (halimbawa, sa Huawei device na walang Google services), hindi magpapakita ang mga mapa. Para sa mga ganitong kaso, inirerekomenda ng Google ang paggamit ng alternatibong solusyon o WebView na may JavaScript Maps API.

// AndroidManifest.xml — metadata ng API key
// <meta-data android:name="com.google.android.geo.API_KEY"
//     android:value="YOUR_API_KEY"/>

// Fragment ng mapa sa 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 sa Android ay sumusuporta sa Indoor Maps — pagpapakita ng floor plan ng gusali (airport, mall). Para i-enable, sapat na itakda ang map.isIndoorEnabled = true. Ang layer ng trapiko (Traffic Layer) ay nagpapakita ng density ng kalsada sa real-time — nag-a-update ang data bawat 2-5 minuto. Ang layer ng transportasyon (Transit Layer) ay nagpapakita ng ruta ng pampublikong transportasyon sa mga supported na lungsod.

Maps SDK para sa iOS: configuration at paggamit

Maps SDK para sa iOS ay nagbibigay ng parehong kakayahan gaya ng Android na bersyon, ngunit inangkop para sa Apple platform. Ang integrasyon ay ginagawa sa pamamagitan ng Swift Package Manager o CocoaPods. Ang Maps SDK para sa iOS ay gumagamit ng Google server para sa rendering ng mapa, ngunit maaaring gumana kasama ng Apple MapKit para sa native na nabigasyon. Sinusuportahan ng SDK ang iOS 15 at mas bago, pati na rin ang SwiftUI sa pamamagitan ng UIViewRepresentable.

Ang espesyalidad ng iOS na bersyon — sapilitang configuration ng Info.plist na may API key at pagdaragdag ng URL scheme para sa Google Maps. Hindi tulad ng Android, ang iOS SDK ay hindi nangangailangan ng Google Play Services, ngunit nangangailangan ng naka-install na Google Maps application para sa ilang function (halimbawa, pagbukas ng mapa sa nabigasyon). Para sa cross-platform na proyekto, inirerekomenda ng Google ang iisang API key bawat proyekto, na naka-activate para sa parehong platform.

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
    }
}

Sa iOS, Google Maps SDK ay sumusuporta sa custom na estilo sa pamamagitan ng JSON file sa Google Maps Styling format. Ang estilo ay nagbibigay-daan sa pagbabago ng kulay ng kalsada, tubig, parke, at gusali ayon sa disenyo ng application. Sinusuportahan din ang Heatmap Layer para sa visualization ng data density, KML at GeoJSON para sa pag-import ng heyograpikong data mula sa external na source.

Places API: paghahanap ng lugar at geocoding

Places API — ay serbisyo ng Google Maps Platform para sa pagkuha ng impormasyon tungkol sa mga heyograpikong lugar: address, coordinate, rating, oras ng trabaho, larawan, at review. Gumagana ang Places API sa dalawang mode: Place Search (paghahanap ng lugar ayon sa text o radius) at Place Details (pagkuha ng detalyadong impormasyon tungkol sa partikular na lugar ayon sa Place ID). Available ang SDK para sa Android, iOS, at bilang REST API.

Ang Places SDK para sa Android at iOS ay nagpapahintulot sa pag-embed ng autocomplete ng address (Place Autocomplete) nang direkta sa text field ng application. Ito ay pangunahing function para sa delivery, taxi, at logistics application — magsisimulang mag-type ang user ng address, at nag-aalok ang SDK ng mga opsyon mula sa Google Maps database. Place Autocomplete ay nagbabawas ng error sa pag-input ng address ng 80% kumpara sa manu-manong pag-input. Pagbabayad ng Places API: $2.83 bawat 1000 Place Details request, Place Search — $4.71 bawat 1000.

// Paghahanap ng lugar ayon sa text sa 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: autocomplete ng address

Geocoding API — reverse geocoding (coordinate → address) at direktang (address → coordinate). Ginagamit para sa pag-convert ng address na in-input ng user sa coordinate para sa pagpapakita sa mapa. Ang Geocoding API ay nasingil nang hiwalay: $4.71 bawat 1000 request. Nagbibigay ang Google ng 200 libreng request bawat araw bawat account para sa pagsubok.

Directions API: pagbuo ng ruta

Directions API — serbisyo para sa pagkalkula ng ruta sa pagitan ng dalawa o higit pang punto na isinasaalang-alang ang uri ng transportasyon (kotse, paglalakad, bisikleta, pampublikong transportasyon). Ang API ay nagbabalik ng ilang alternatibong ruta na may distansya, oras ng biyahe, step-by-step na tagubilin, at polyline para sa pagguhit ng ruta sa mapa. Available ang Directions API bilang REST API at sa pamamagitan ng client SDK.

Pinalawak na functionality — Routes API (bagong API, inirerekomenda ng Google mula 2024). Nag-aalok ang Routes API ng pinahusay na routing na may real-time na trapiko, ecological footprint (eco-friendly routing), at predictive analysis ng oras ng pagdating. Ayon sa Google, ang Routes API ay 20% mas tumpak sa pagkalkula ng oras ng biyahe sa urban na kondisyon kumpara sa classic na Directions API. Ang Routes API ay nasingil: $5.00 bawat 1000 request.

// Request ng ruta sa pamamagitan ng 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 ay sumusuporta ng hanggang 25 waypoints para sa isang ruta. Ang waypoints ay maaaring itakda bilang coordinate o Place ID. Para i-optimize ang pagkakasunod-sunod ng punto (traveling salesman problem), gamitin ang parameter na optimize:true. Pagbabayad: Directions API — $4.71 bawat 1000 request (hanggang 10 punto), bawat karagdagang punto ay nagdaragdag ng 50% sa halaga ng request.

Pag-customize ng mapa: estilo, marker, at impormasyon window

Google Maps SDK ay nagbibigay ng malawak na kakayahan sa pag-customize: pagbabago ng color scheme ng mapa sa pamamagitan ng JSON style, pagdaragdag ng custom na marker (kabilang ang animated), impormasyon window (InfoWindow) na may kahit anong nilalaman, at pag-overlay ng graphic layer (GroundOverlay, Circle, Polygon). Ang pag-customize ay nagpapahintulot na iakma ang mapa sa brand ng application at mapabuti ang karanasan ng user.

Pag-istilo ng mapa ay ginagawa sa pamamagitan ng Google Maps Styling Wizard o JSON file sa Map Style format. Maaaring baguhin ang kulay ng kalsada (featureType: road), tubig (water), parke (poi.park), gusali (building), at iba pang elemento. Para sa mapa sa dark theme ng application, gamitin ang night style na may dark background at muted na kulay. Ang Google Maps ay sumusuporta ng hanggang 100 style rule sa isang JSON file.

Clustering: pag-cluster ng marker para sa performance

Clustering — pagsasama-sama ng marker sa cluster kapag maraming punto sa mapa. Ang Google Maps SDK para sa Android at iOS ay may kasamang built-in na clustering utility (com.google.maps.android:android-maps-utils). Pinipigilan ng Clustering ang pag-overload ng mapa sa marker sa zoom na nasa ibaba ng partikular na level. Kapag nag-zoom, ang cluster ay awtomatikong nahahati sa indibidwal na marker. Ayon sa Google, ang clustering ay nagpapabuti ng performance ng mapa ng 40% sa 1000+ marker.

Halimbawa ng code: mapa na may marker sa Kotlin

Buong halimbawa ng pagpapakita ng mapa na may custom na marker, polyline ng ruta, at impormasyon window. Ipinapakita ng application ang mapa ng Moscow na may punto ng interes at ruta papunta dito mula sa sentro ng lungsod. Ang code ay nagpapakita ng pangunahing kakayahan ng Google Maps SDK: pagdaragdag ng marker, pagguhit ng polyline, paglipat ng camera, at pag-handle ng click.

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("Kremlin")
            .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()
        }
    }
}

Rekomendasyon sa performance: gamitin ang async loading ng marker sa pamamagitan ng ClusterManager kapag higit sa 200 punto, limitahan ang bilang ng visible polyline (inirerekomenda ng Google na hindi hihigit sa 100 sabay-sabay), gamitin ang Lite Mode para sa mapa na hindi nangangailangan ng buong functionality (pag-scroll nang hindi binabago ang zoom). Binabawasan ng Lite Mode ang memory consumption ng 50% at pinapabilis ang pag-load ng mapa ng 2 beses.

Presyo at limitasyon ng Google Maps Platform

Google Maps Platform ay gumagamit ng Pay-as-you-go na modelo ng pagbabayad na may buwanang libreng limit na $200 credits. Bawat API ay nasingil nang hiwalay: Maps SDK — $2.83 bawat 1000 pag-load ng mapa, Places API — $4.71 bawat 1000 request, Directions API — $4.71 bawat 1000 ruta. Routes API (inirerekomenda) — $5.00 bawat 1000 request. Ang libreng limit na $200 ay karaniwang sumasaklaw ng hanggang 70,000 pag-load ng mapa bawat buwan.

Para sa high-load na proyekto, nag-aalok ang Google ng diskwento para sa volume na 500,000 request bawat buwan. Google Maps SDK ay hindi sinisingil para sa pagpapakita ng base na mapa nang walang interaksyon — bayad ay sinisingil lamang para sa pag-load (map load). Bawat beses na bubuksan ng user ang screen na may mapa, ito ay binibilang bilang isang pag-load. Pag-optimize: pag-cache ng tile ng mapa ay nagbabawas ng bilang ng pag-load sa muling pagbukas.

Limitasyon: 300 request bawat minuto para sa Places API (maaaring dagdagan sa 3000 sa pamamagitan ng quota sa Cloud Console). Para sa Directions API — 100 request bawat minuto. Ang paglampas sa limitasyon ay nagbabalik ng error na OVER_QUERY_LIMIT. Inirerekomenda ng Google ang paggamit ng exponential backoff para sa paulit-ulit na request. Ang pag-monitor ng paggamit ay available sa Google Cloud Console na may delay na hanggang 5 minuto.