इस विषय में बताया गया है कि Android के लिए Maps SDK टूल का इस्तेमाल करने के लिए, प्रोजेक्ट कॉन्फ़िगर करने के बाद, Android ऐप्लिकेशन में बेसिक मैप कैसे जोड़ा जा सकता है. मैप जोड़ने के बाद, मैप का टाइप और सुविधाएं बदली जा सकती हैं.
खास जानकारी
Android के लिए Maps SDK टूल में ऐसी कई क्लास मिलती हैं जिनका इस्तेमाल करके आपका ऐप्लिकेशन, मैप की लाइफ़साइकल, फ़ंक्शन, और डेटा को मैनेज कर सकता है. इन क्लास में, Android यूज़र इंटरफ़ेस (यूआई) मॉडल के आधार पर उपयोगकर्ता के इंटरैक्शन का इस्तेमाल किया जा सकता है. उदाहरण के लिए, मैप की शुरुआती स्थिति सेट करना और रनटाइम के दौरान, उपयोगकर्ता के जेस्चर वाले इनपुट का रिस्पॉन्स देना.
मैप मैनेज करने के लिए मुख्य इंटरफ़ेस और क्लास:
GoogleMap— मैप की सुविधाओं और डेटा को मैनेज करने का एंट्री पॉइंट. आपका ऐप्लिकेशनGoogleMapऑब्जेक्ट को सिर्फ़ तब ऐक्सेस कर सकता है, जब उसेSupportMapFragmentयाMapViewऑब्जेक्ट से वापस लाया गया हो.SupportMapFragment—GoogleMapऑब्जेक्ट के लाइफ़साइकल को मैनेज करने के लिए, एक फ़्रैगमेंट.MapView— किसीGoogleMapऑब्जेक्ट के लाइफ़साइकल को मैनेज करने के लिए, एक व्यू.OnMapReadyCallback— एक कॉलबैक इंटरफ़ेस, जोGoogleMapऑब्जेक्ट के लिए इवेंट और उपयोगकर्ता इंटरैक्शन को मैनेज करता है.
कोई GoogleMap ऑब्जेक्ट अपने-आप ये काम करता है:
- Google Maps सेवा से कनेक्ट किया जा रहा है.
- मैप टाइल डाउनलोड हो रही हैं.
- डिवाइस की स्क्रीन पर टाइल दिख रही हैं.
- पैन और ज़ूम जैसे अलग-अलग कंट्रोल दिखाए जा रहे हैं.
- मैप को इधर-उधर ले जाकर और ज़ूम इन या ज़ूम आउट करके, पैन और ज़ूम करने के जेस्चर पर कार्रवाई करना.
अपने ऐप्लिकेशन में GoogleMap ऑब्जेक्ट का इस्तेमाल करने के लिए, आपको मैप के लिए कंटेनर ऑब्जेक्ट के तौर पर,
SupportMapFragment या MapView ऑब्जेक्ट का इस्तेमाल करना होगा. इसके बाद, कंटेनर से GoogleMap ऑब्जेक्ट को वापस पाना होगा. कंटेनर क्लास या तो Android फ़्रैगमेंट या व्यू से ली जाती हैं, इसलिए वे अपने Android बेस क्लास की लाइफ़साइकल मैनेजमेंट और यूज़र इंटरफ़ेस (यूआई) क्षमताओं के साथ मैप उपलब्ध कराती हैं.
किसी GoogleMap ऑब्जेक्ट के लिए, SupportMapFragment क्लास ज़्यादा मॉडर्न और सामान्य कंटेनर है.
कोड देखें
नीचे दिया गया कोड, इस विषय में इस्तेमाल की गई उस पूरी Java गतिविधि से लिया गया है जिसका इस्तेमाल स्टैटिक तरीके से फ़्रैगमेंट जोड़ते समय किया गया था. Android प्रोजेक्ट को खाली प्रोजेक्ट टेंप्लेट से बनाया गया था और फिर प्रोजेक्ट कॉन्फ़िगरेशन गाइड के आधार पर अपडेट किया गया था. इस विषय में दिए गए चरणों को पूरा करने के बाद, प्रोजेक्ट टेंप्लेट के आधार पर आपका कोड अलग-अलग हो सकता है.
package com.example.mapsetup;
import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.MarkerOptions;
// Implement OnMapReadyCallback.
public class MainActivity extends AppCompatActivity implements OnMapReadyCallback {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// Set the layout file as the content view.
setContentView(R.layout.activity_main);
// Get a handle to the fragment and register the callback.
SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
.findFragmentById(R.id.map);
mapFragment.getMapAsync(this);
}
// Get a handle to the GoogleMap object and display marker.
@Override
public void onMapReady(GoogleMap googleMap) {
googleMap.addMarker(new MarkerOptions()
.position(new LatLng(0, 0))
.title("Marker"));
}
}
मैप जोड़ने के लिए
इस सेक्शन में फ़्रैगमेंट को मैप कंटेनर के तौर पर इस्तेमाल करके, बेसिक मैप जोड़ने का तरीका बताया गया है. हालांकि, इसके बजाय व्यू का इस्तेमाल किया जा सकता है. उदाहरण के लिए, GitHub पर RawMapViewDemoActivity देखें.
बुनियादी चरण:
SDK टूल पाने के लिए, एपीआई पासकोड पाएं, और ज़रूरी फ़्रेमवर्क जोड़ें. इसके लिए, यहां दिया गया तरीका अपनाएं:
उस गतिविधि में
SupportMapFragmentऑब्जेक्ट जोड़ें जो मैप को हैंडल करेगी. फ़्रैगमेंट को स्टैटिक या डाइनैमिक तौर पर जोड़ा जा सकता है.OnMapReadyCallbackइंटरफ़ेस लागू करें.लेआउट फ़ाइल को कॉन्टेंट व्यू के तौर पर सेट करें.
अगर आपने फ़्रैगमेंट को स्टैटिक तरीके से जोड़ा है, तो फ़्रैगमेंट के लिए हैंडल पाएं.
कॉलबैक को रजिस्टर करें.
GoogleMapऑब्जेक्ट के लिए हैंडल पाएं.
SupportMapफ़्रैगमेंट ऑब्जेक्ट जोड़ें
अपने ऐप्लिकेशन में, SupportMapFragment ऑब्जेक्ट को स्टैटिक या डाइनैमिक तौर पर जोड़ा जा सकता है.
सबसे आसान तरीका यह है कि इसे स्टैटिक तरीके से जोड़ा जाए. अगर फ़्रैगमेंट को डाइनैमिक तौर पर जोड़ा जाता है, तो फ़्रैगमेंट पर अन्य कार्रवाइयां की जा सकती हैं. जैसे, रनटाइम के दौरान इसे हटाना और बदलना.
स्टैटिक तरीके से फ़्रैगमेंट जोड़ने के लिए
गतिविधि की लेआउट फ़ाइल में, जो मैप को हैंडल करेगी:
fragmentएलिमेंट जोड़ें.- नाम का एलान जोड़ें
xmlns:map="http://schemas.android.com/apk/res-auto". इससेmapsकस्टम एक्सएमएल एट्रिब्यूट का इस्तेमाल चालू हो जाता है. fragmentएलिमेंट में,android:nameएट्रिब्यूट कोcom.google.android.gms.maps.SupportMapFragmentपर सेट करें.fragmentएलिमेंट में,android:idएट्रिब्यूट जोड़ें और इसे R.id.map संसाधन आईडी (@+id/map) पर सेट करें.
उदाहरण के लिए, यहां एक पूरी लेआउट फ़ाइल दी गई है, जिसमें fragment एलिमेंट शामिल है:
<?xml version="1.0" encoding="utf-8"?>
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:map="http://schemas.android.com/apk/res-auto"
android:name="com.google.android.gms.maps.SupportMapFragment"
android:id="@+id/map"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
डाइनैमिक तौर पर फ़्रैगमेंट जोड़ने के लिए
गतिविधि में:
SupportMapFragmentइंस्टेंस बनाएं.- ऐसा ट्रांज़ैक्शन करें जो गतिविधि में फ़्रैगमेंट जोड़ता है. ज़्यादा जानकारी के लिए, फ़्रैगमेंट ट्रांज़ैक्शन देखें.
उदाहरण के लिए:
Kotlin
val mapFragment = SupportMapFragment.newInstance()
supportFragmentManager
.beginTransaction()
.add(R.id.my_container, mapFragment)
.commit()
Java
SupportMapFragment mapFragment = SupportMapFragment.newInstance();
getSupportFragmentManager()
.beginTransaction()
.add(R.id.my_container, mapFragment)
.commit();
OnMapReadyCallback इंटरफ़ेस लागू करें
गतिविधि के एलान को इस तरह से अपडेट करें:
Kotlin
class MainActivity : AppCompatActivity(), OnMapReadyCallback {
// ...
}
Java
class MainActivity extends AppCompatActivity implements OnMapReadyCallback {
// ...
}
कॉन्टेंट व्यू सेट करना
अपनी गतिविधि के onCreate तरीके में, setContentView तरीके को कॉल करें और लेआउट फ़ाइल को कॉन्टेंट व्यू के तौर पर सेट करें.
उदाहरण के लिए, अगर लेआउट फ़ाइल का नाम main.xml है:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.main)
}
Java
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
}
फ़्रैगमेंट का हैंडल पाएं और कॉलबैक रजिस्टर करें
फ़्रैगमेंट का हैंडल पाने के लिए,
FragmentManager.findFragmentByIdतरीके को कॉल करें और उसे अपनी लेआउट फ़ाइल में फ़्रैगमेंट का संसाधन आईडी पास करें. अगर आपने फ़्रैगमेंट को डाइनैमिक तरीके से जोड़ा है, तो यह चरण छोड़ दें, क्योंकि आपने हैंडल को पहले ही वापस ले लिया है.फ़्रैगमेंट पर कॉलबैक सेट करने के लिए,
getMapAsyncतरीके को कॉल करें.
उदाहरण के लिए, अगर आपने फ़्रैगमेंट को स्टैटिक तरीके से जोड़ा है:
Kotlin
val mapFragment = supportFragmentManager
.findFragmentById(R.id.map) as SupportMapFragment
mapFragment.getMapAsync(this)
Java
SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
.findFragmentById(R.id.map);
mapFragment.getMapAsync(this);
GoogleMap ऑब्जेक्ट के लिए हैंडल पाएं
GoogleMapऑब्जेक्ट को हैंडल करने के लिए, onMapReady कॉलबैक मैथड का इस्तेमाल करें. कॉलबैक तब ट्रिगर होता है, जब मैप उपयोगकर्ता से इनपुट पाने के लिए तैयार होता है. यह GoogleMap क्लास का एक ऐसा इंस्टेंस देता है जो शून्य नहीं है. इसका इस्तेमाल मैप अपडेट करने के लिए किया जा सकता है.
इस उदाहरण में, onMapReady कॉलबैक, GoogleMap ऑब्जेक्ट में एक हैंडल हासिल करता है और फिर मैप में एक मार्कर जोड़ दिया जाता है:
Kotlin
override fun onMapReady(googleMap: GoogleMap) {
googleMap.addMarker(
MarkerOptions()
.position(LatLng(0.0, 0.0))
.title("Marker")
)
}
Java
@Override
public void onMapReady(GoogleMap googleMap) {
googleMap.addMarker(new MarkerOptions()
.position(new LatLng(0, 0))
.title("Marker"));
}
ऐप्लिकेशन को बनाने और चलाने के बाद, यह नल आइलैंड (शून्य डिग्री अक्षांश और शून्य डिग्री देशांतर) पर मार्कर के साथ एक मैप दिखाएगा.
पूरी गतिविधि का कोड देखें:
आगे क्या करना है
इन चरणों को पूरा करने के बाद, आप मैप सेटिंग कॉन्फ़िगर कर सकते हैं.