Google Xaritalar loyihasini yarating Android Studio -ni oching va Android Studio -ga xush kelibsiz oynasida Yangi loyiha yaratish -ni bosing. Yangi loyiha oynasida "Telefon va planshet" toifasini toping. Google Xaritalar faolligini tanlang va Keyingiga bosing.
Google Xaritalar Faoliyati shaklini to'ldiring:
Til maydonida Java yoki Kotlin -ni tanlang. Android uchun Maps SDK bu ikkala tilni ham to'liq qo'llab -quvvatlaydi. Kotlin haqida ko'proq ma'lumotni bu erda topishingiz mumkin.
Minimal SDK versiyasini ko'rsating. Bu sizning sinov qurilmangiz qo'llab -quvvatlaydigan Android SDK versiyasi bo'lishi kerak.
Finish tugmasini bosing.
Amaliy qism. Loyihani qurishni tugatganingizdan so'ng, Android Studio Gradle -ni ishga tushiradi. Bu biroz vaqt olishi mumkin. Qurilish tugagach, google_maps_api.xml va MapsActivity fayllari Android Studio -da ochiladi. Agar siz uni sozlash paytida ko'rsatgan bo'lsangiz, sizning ob'ektingiz boshqa nomga ega bo'lishi mumkin.
API kalitini ilovaga qo'shing Bu bo'lim sizning ilovangiz tomonidan API kalitiga xavfsiz qo'ng'iroqni qanday o'rnatishni tushuntiradi. API kalitini manba boshqaruviga kiritish istalmagan, shuning uchun uni loyihangiz ildizida joylashgan local.properties faylida saqlashni tavsiya qilamiz. Local.properties fayli Gradle xususiyatlari fayllari tavsifida batafsilroq tasvirlangan
Ishni osonlashtirish uchun Android uchun Secrets Gradle plaginidan foydalaning.
Plaginni o'rnatish va API kalitlarini saqlashni sozlash uchun quyidagi amallarni bajaring:
Android Studio -da build.gradle ildiz darajasidagi faylni oching va quyidagi kodni buildscript elementiga tegishli bog'liqliklar elementiga qo'shing..
buildscript {
dependencies {
// ...
classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:1.3.0"
}
}
Dastur darajasidagi build.gradle faylini oching va plaginlar elementiga quyidagi kodni qo'shing.
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Faylni saqlang va loyihani Gradle bilan sinxronlashtiring.
Loyiha darajasidagi katalogda local.properties faylini oching va faylga quyidagi kodni qo'shing. YOUR_API_KEY ni API kalitingiz bilan almashtiring.
MAPS_API_KEY=YOUR_API_KEY Faylni saqlang va loyihani Gradle bilan sinxronlashtiring..
AndroidManifest.xml faylida com.google.android.geo.API_KEY qismini toping va android: value atributini quyidagicha o'zgartiring:
android:name="com.google.android.geo.API_KEY"
android:value="${MAPS_API_KEY}" />
Xarita uchun harakatlar fayli
Xaritadagi harakatlar fayli dastur uchun asosiy operatsion fayl hisoblanadi. U xaritani ko'rsatish va boshqarish kodini o'z ichiga oladi. Odatiy bo'lib, bu faylga MapsActivity.java nomi berilgan. Agar siz ilovangiz uchun Kotlin -ni til sifatida tanlagan bo'lsangiz, u MapsActivity.kt deb nomlanadi.
Activity faylining asosiy elementlari
SupportMapFragment obyekti xaritaning hayotiy tsiklini boshqaradi va dastur interfeysining boshidir.
GoogleMap obyekti xarita ma'lumotlari va taqdimotga kirishni ta'minlaydi. Bu Android uchun Maps SDK asosiy sinfidir.
moveCamera funktsiyasi xaritani LatLng koordinatalarida markazlashtiradi (Sidney, Avstraliya). Odatda, xaritani qo'shganda, birinchi navbatda, joylashuv va kamera sozlamalarini o'zgartirish kerak: ko'rish burchagi, xaritaning yo'nalishi, shkalasi va boshqalar.
addMarker funktsiyasi Sidney koordinatalariga marker qo'shadi.