Google Maps SDK — یہ کیا ہے، Google نقشے اور ڈیولپمنٹ کے لیے API

Google Maps SDK کیا ہے؟

Google Maps SDK — یہ ڈیولپرز کے لیے ایک جامع پلیٹ فارم ہے جو ایپلیکیشنز میں جغرافیائی ڈیٹا کے ساتھ کام کرنے کے لیے ٹولز فراہم کرتا ہے۔ پلیٹ فارم میں کئی API شامل ہیں: Maps SDK (نقشوں کی نمائش)، Routes API (راستے)، Places API (مقام کی تلاش اور جیوڈیٹا) اور Geocoding API (پتوں کو کوآرڈینیٹ میں تبدیل کرنا)۔ ہر SDK علیحدہ طور پر ضم ہوتا ہے اور اس کا اپنا بلنگ ماڈل ہوتا ہے۔

Apple MapKit کے برعکس، Google Maps SDK ڈیٹا کا ایک وسیع سیٹ فراہم کرتا ہے: 250 ملین مقامات کے بارے میں معلومات، ریئل ٹائم ٹریفک، Street View پینوراماز اور انڈور مقامات کے لیے Indoor Maps۔ Statista (2025) کے مطابق، Google Maps Platform موبائل ایپلیکیشنز میں میپنگ SDK مارکیٹ کا 75% حصہ رکھتا ہے۔ بنیادی فائدہ — تمام Google Maps خدمات کے لیے ایک واحد API کلید اور کراس پلیٹ فارم انضمام (Android, iOS, ویب)۔

API کلید اور حفاظتی ترتیبات

API کلید — Google Maps SDK کے ساتھ کام کرنے کے لیے لازمی عنصر ہے۔ کلید Google Cloud Console میں بنائی جاتی ہے اور ایک مخصوص پروجیکٹ سے منسلک ہوتی ہے۔ Android کے لیے اضافی طور پر ایپلیکیشن سرٹیفکیٹ کے SHA-1 کی وضاحت کرنا ضروری ہے، iOS کے لیے — Bundle Identifier۔ Google غیر مجاز رسائی کو روکنے کے لیے API کلید کے استعمال کو IP پتوں، HTTP ریفررز یا ایپلیکیشن پیکجز تک محدود کرنے کی سفارش کرتا ہے۔

Android کے لیے Maps SDK: انضمام اور صلاحیتیں

Android کے لیے Maps SDK — یہ ایک لائبریری ہے جو Android ایپلیکیشن کے اندر MapView یا SupportMapFragment کے ذریعے انٹرایکٹو Google نقشے دکھاتی ہے۔ SDK معاونت کرتا ہے: کسٹم نقشہ اسٹائل، معلوماتی ونڈو کے ساتھ مارکر، پولیگون اور پولی لائن، ٹریفک اور ٹرانسپورٹ لیئرز، نیز ٹچ ایونٹس اور جیسچرز (زوم، گھمانا، جھکانا)۔ نقشے رینڈرنگ کے لیے OpenGL استعمال کرتے ہیں، جو جدید آلات پر 60 FPS یقینی بناتے ہیں۔

انضمام build.gradle میں انحصار شامل کرنے اور AndroidManifest.xml کے ذریعے API کلید سیٹ کرنے سے شروع ہوتا ہے۔ Android کے لیے Google Maps SDK کو ڈیوائس پر Google Play Services کی ضرورت ہوتی ہے۔ اگر Google Play Services موجود نہیں ہے (مثال کے طور پر، Google خدمات کے بغیر Huawei آلات پر)، تو نقشے ظاہر نہیں ہوں گے۔ ایسے معاملات کے لیے Google متبادل حل یا JavaScript Maps API کے ساتھ WebView استعمال کرنے کی سفارش کرتا ہے۔

// AndroidManifest.xml — API کلید میٹا ڈیٹا
// <meta-data android:name="com.google.android.geo.API_KEY"
//     android:value="YOUR_API_KEY"/>

// ایکٹیویٹی میں نقشہ کا ٹکڑا
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))
    }
}

Android پر Google Maps SDK Indoor Maps کی معاونت کرتا ہے — عمارتوں (ہوائی اڈے، شاپنگ سینٹر) کے فرش پلان دکھانا۔ اسے فعال کرنے کے لیے بس map.isIndoorEnabled = true سیٹ کریں۔ ٹریفک لیئر (Traffic Layer) ریئل ٹائم میں سڑکوں کی بھیڑ دکھاتی ہے — ڈیٹا ہر 2-5 منٹ میں اپ ڈیٹ ہوتا ہے۔ ٹرانسپورٹ لیئر (Transit Layer) معاون شہروں میں پبلک ٹرانسپورٹ کے راستے دکھاتی ہے۔

iOS کے لیے Maps SDK: سیٹ اپ اور استعمال

iOS کے لیے Maps SDK Android ورژن جیسی صلاحیتیں فراہم کرتا ہے، لیکن Apple پلیٹ فارم کے مطابق ڈھالا گیا ہے۔ انضمام Swift Package Manager یا CocoaPods کے ذریعے کیا جاتا ہے۔ iOS کے لیے Maps SDK نقشوں کی رینڈرنگ کے لیے Google سرور استعمال کرتا ہے، لیکن مقامی نیویگیشن کے لیے Apple MapKit کے ساتھ مل کر کام کر سکتا ہے۔ SDK iOS 15 اور اس سے اوپر کی معاونت کرتا ہے، نیز UIViewRepresentable کے ذریعے SwiftUI کی بھی۔

iOS ورژن کی خصوصیت — API کلید کی وضاحت اور Google Maps کے لیے URL اسکیما شامل کرنے کے ساتھ Info.plist کی لازمی کنفیگریشن۔ Android کے برعکس، iOS SDK کو Google Play Services کی ضرورت نہیں ہے، لیکن کچھ افعال کے لیے Google Maps ایپلیکیشن انسٹال ہونا ضروری ہے (مثلاً، نیویگیشن میں نقشہ کھولنا)۔ کراس پلیٹ فارم پروجیکٹس کے لیے Google دونوں پلیٹ فارمز کے لیے فعال ایک واحد پروجیکٹ API کلید کی سفارش کرتا ہے۔

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

iOS پر Google Maps SDK Google Maps Styling فارمیٹ میں JSON فائل کے ذریعے کسٹم اسٹائلز کی معاونت کرتا ہے۔ اسٹائلز آپ کو ایپلیکیشن ڈیزائن کے مطابق سڑکوں، پانی، پارکوں اور عمارتوں کے رنگ بدلنے کی اجازت دیتے ہیں۔ ڈیٹا کثافت ویژولائزیشن کے لیے Heatmap Layer، بیرونی ذرائع سے جغرافیائی ڈیٹا درآمد کرنے کے لیے KML اور GeoJSON بھی معاون ہیں۔

Places API: مقام کی تلاش اور جیوکوڈنگ

Places API — یہ Google Maps Platform کی ایک خدمت ہے جو جغرافیائی مقامات کے بارے میں معلومات حاصل کرنے کے لیے ہے: پتے، کوآرڈینیٹ، ریٹنگ، کام کے اوقات، تصاویر اور جائزے۔ Places API دو موڈز میں کام کرتا ہے: Place Search (متن یا رداس کے ذریعے مقام کی تلاش) اور Place Details (Place ID کے ذریعے مخصوص مقام کے بارے میں تفصیلی معلومات حاصل کرنا)۔ SDK Android، iOS اور REST API کے طور پر دستیاب ہے۔

Android اور iOS کے لیے Places SDK ایپلیکیشن کے ٹیکسٹ فیلڈز میں براہ راست پتہ آٹو کمپلیٹ (Place Autocomplete) کو ایمبیڈ کرنے کی اجازت دیتا ہے۔ یہ ڈیلیوری، ٹیکسی اور لاجسٹکس ایپلیکیشنز کے لیے ایک اہم خصوصیت ہے — صارف پتہ ٹائپ کرنا شروع کرتا ہے، اور SDK Google Maps ڈیٹابیس سے آپشنز تجویز کرتا ہے۔ Place Autocomplete دستی پتہ اندراج کے مقابلے میں پتہ اندراج کی غلطیوں کو 80% تک کم کرتا ہے۔ Places API بلنگ: $2.83 فی 1000 Place Details درخواست، Place Search — $4.71 فی 1000۔

// 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 — ریورس جیوکوڈنگ (کوآرڈینیٹ → پتہ) اور ڈائریکٹ (پتہ → کوآرڈینیٹ)۔ نقشے پر دکھانے کے لیے صارف کے درج کردہ پتے کو کوآرڈینیٹ میں تبدیل کرنے کے لیے استعمال ہوتا ہے۔ Geocoding API علیحدہ فیس لیتا ہے: $4.71 فی 1000 درخواست۔ Google جانچ کے لیے فی اکاؤنٹ روزانہ 200 مفت درخواستیں فراہم کرتا ہے۔

Directions API: راستے بنانا

Directions API — دو یا زیادہ پوائنٹس کے درمیان نقل و حمل کے ذریعہ (کار، پیدل، سائیکل، پبلک ٹرانسپورٹ) کو مدنظر رکھتے ہوئے راستوں کا حساب لگانے کی خدمت۔ API فاصلہ، سفر کا وقت، مرحلہ وار ہدایات اور نقشے پر راستہ کھینچنے کے لیے پولی لائن کے ساتھ کئی متبادل راستے واپس کرتا ہے۔ Directions API REST API اور کلائنٹ SDK کے ذریعے دستیاب ہے۔

توسیعی فعالیت — Routes API (نیا API، Google کی طرف سے 2024 سے تجویز کردہ)۔ Routes API ریئل ٹائم ٹریفک، ماحولیاتی اثرات (eco-friendly routing) اور آمد کے وقت کے پیش گوئی تجزیہ کو مدنظر رکھتے ہوئے بہتر روٹنگ فراہم کرتا ہے۔ Google کے مطابق، Routes API شہری حالات میں کلاسک Directions API کے مقابلے میں سفر کے وقت کا 20% زیادہ درست حساب لگاتا ہے۔ Routes API فیس: $5.00 فی 1000 درخواست۔

// 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 ایک راستے کے لیے 25 انٹرمیڈیٹ پوائنٹس (waypoints) تک کی معاونت کرتا ہے۔ Waypoints کو کوآرڈینیٹ یا Place ID کے طور پر متعین کیا جا سکتا ہے۔ پوائنٹس کی ترتیب کو بہتر بنانے کے لیے (traveling salesman problem) optimize:true پیرامیٹر استعمال کریں۔ فیس: Directions API — $4.71 فی 1000 درخواست (10 پوائنٹس تک)، ہر اضافی پوائنٹ درخواست کی لاگت میں 50% اضافہ کرتا ہے۔

نقشوں کی حسب ضرورت: اسٹائل، مارکر اور معلوماتی ونڈو

Google Maps SDK حسب ضرورت کی وسیع امکانات فراہم کرتا ہے: JSON اسٹائلز کے ذریعے نقشے کی رنگ سکیم تبدیل کرنا، کسٹم مارکر (متحرک سمیت)، صوابدیدی مواد کے ساتھ معلوماتی ونڈو (InfoWindow) اور گرافیکل لیئرز (GroundOverlay, Circle, Polygon) کا اوورلے۔ حسب ضرورت آپ کو ایپلیکیشن کے برانڈ کے مطابق نقشہ ڈھالنے اور صارف کے تجربے کو بہتر بنانے کی اجازت دیتی ہے۔

نقشہ اسٹائلنگ Google Maps Styling Wizard یا Map Style فارمیٹ میں JSON فائل کے ذریعے کی جاتی ہے۔ آپ سڑکوں (featureType: road)، پانی (water)، پارکوں (poi.park)، عمارتوں (building) اور دیگر عناصر کے رنگ بدل سکتے ہیں۔ ایپلیکیشن کے ڈارک تھیم والے نقشوں کے لیے گہرے پس منظر اور مدھم رنگوں کے ساتھ رات کا اسٹائل استعمال کریں۔ Google Maps ایک JSON فائل میں 100 اسٹائل قواعد تک کی معاونت کرتا ہے۔

Clustering: کارکردگی کے لیے مارکر کلسٹرنگ

Clustering — نقشے پر بڑی تعداد میں پوائنٹس ہونے پر مارکرز کو کلسٹرز میں گروپ کرنا۔ Android اور iOS کے لیے Google Maps SDK میں بلٹ ان کلسٹرنگ یوٹیلیٹی (com.google.maps.android:android-maps-utils) شامل ہے۔ Clustering ایک مخصوص سطح سے نیچے زوم کرنے پر نقشے کو مارکرز سے بھرنے سے روکتا ہے۔ زوم کرنے پر کلسٹر خود بخود الگ الگ مارکرز میں تقسیم ہو جاتا ہے۔ Google کے مطابق، 1000+ مارکرز پر کلسٹرنگ نقشے کی کارکردگی کو 40% بہتر کرتی ہے۔

کوڈ مثال: Kotlin میں مارکر کے ساتھ نقشہ

کسٹم مارکر، راستے کی پولی لائن اور معلوماتی ونڈو کے ساتھ نقشہ دکھانے کی مکمل مثال۔ ایپلیکیشن شہر کے مرکز سے دلچسپی کے مقام اور اس کے راستے کے ساتھ ماسکو کا نقشہ دکھاتی ہے۔ کوڈ Google Maps SDK کی بنیادی صلاحیتوں کو ظاہر کرتا ہے: مارکر شامل کرنا، پولی لائن کھینچنا، کیمرہ منتقل کرنا اور کلکس کو ہینڈل کرنا۔

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("کریملن")
            .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()
        }
    }
}

کارکردگی کی سفارشات: 200 سے زیادہ پوائنٹس ہونے پر ClusterManager کے ذریعے مارکرز کی async لوڈنگ استعمال کریں، نظر آنے والی پولی لائنز کی تعداد محدود کریں (Google ایک ساتھ 100 سے زیادہ نہ رکھنے کی سفارش کرتا ہے)، ان نقشوں کے لیے Lite Mode استعمال کریں جنہیں مکمل فعالیت کی ضرورت نہیں ہے (زوم تبدیل کیے بغیر اسکرول کرنا)۔ Lite Mode میموری کی کھپت کو 50% تک کم کرتا ہے اور نقشہ لوڈنگ کو 2 گنا تیز کرتا ہے۔

Google Maps Platform کی قیمتوں کا تعین اور حدود

Google Maps Platform Pay-as-you-go ادائیگی ماڈل استعمال کرتا ہے جس کی ماہانہ مفت حد $200 کریڈٹ ہے۔ ہر API علیحدہ فیس لیتا ہے: Maps SDK — $2.83 فی 1000 نقشہ لوڈ، Places API — $4.71 فی 1000 درخواست، Directions API — $4.71 فی 1000 راستہ۔ Routes API (تجویز کردہ) — $5.00 فی 1000 درخواست۔ مفت حد $200 عام طور پر ماہانہ 70,000 نقشہ لوڈ تک کور کرتی ہے۔

زیادہ بوجھ والے پروجیکٹس کے لیے Google ماہانہ 500,000 درخواستوں سے زیادہ حجم پر رعایت فراہم کرتا ہے۔ Google Maps SDK تعامل کے بغیر بیس نقشہ دکھانے پر فیس نہیں لیتا — ادائیگی صرف نقشہ لوڈ پر لی جاتی ہے۔ ہر بار جب صارف نقشے والی اسکرین کھولتا ہے، اسے ایک لوڈ شمار کیا جاتا ہے۔ آپٹیمائزیشن: نقشہ ٹائلز کو کیش کرنے سے بار بار کھولنے پر لوڈ کی تعداد کم ہو جاتی ہے۔

حدود: Places API کے لیے فی منٹ 300 درخواستیں (Cloud Console میں کوٹہ کے ذریعے 3000 تک بڑھائی جا سکتی ہیں)۔ Directions API کے لیے — فی منٹ 100 درخواستیں۔ حد سے تجاوز کرنے پر OVER_QUERY_LIMIT خرابی واپس آتی ہے۔ Google بار بار درخواستوں کے لیے ایکسپونینشل بیک آف استعمال کرنے کی سفارش کرتا ہے۔ استعمال کی نگرانی Google Cloud Console میں 5 منٹ تک کی تاخیر سے دستیاب ہے۔