آموزش Google Maps در اندروید به همراه نمونه کد

اندورید به ما اجازه می دهد تا Google maps را در اپلیکیشن خود جای دهیم.
می توانید لوکیشن ها و یا مسیر های مختلف و غیره را روی نقشه پیدا کنید . همچنین می توانید طبق انتخاب ها و سلایق خود، نقشه را نیز به دلخواه خود تنظیم کنید و به بیان ساده تر به شخصی سازی (customize) گوگل مپ خود بپردازید .

Google map - فایل اکتیویتی 

گوگل برنامه ی GoogleMap و MapFragment api را برای کامل کردن نقشه روی برنامه ی اندروید شما ارائه می دهد. برای استفاده از Google map باید یک آبجکت از آن را ایجاد کنید و از لی اوت فایل xml مرجع را بگیرید .

Google map – فایل لی اوت

اکنون باید fragment  نقشه را به فایل لی اوت xml اضافه کنید.
سینتکس آن مانند زیر می باشد :

<fragment
   android:id="@+id/map"
   android:name="com.google.android.gms.maps.MapFragment"
   android:layout_width="match_parent"
   android:layout_height="match_parent"/>

Google Map - AndroidManifest :

در این مرحله کاری که باید انجام دهید این است که برخی مجوز ها را همراه با کلید Google Map API در فایل AndroidManifest اضافه کنید . سینتکس زیر را در نظر بگیرید :

<!--Permissions-->

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="com.google.android.providers.gsf.permission.
   READ_GSERVICES" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

<!--Google MAP API key-->

<meta-data
   android:name="com.google.android.maps.v2.API_KEY"
   android:value="AIzaSyDKymeBXNeiFWY5jRUejv6zItpmr2MVyQ0" />  

شخصی کردن گوگل مپ (Customizing Google Map): 

شما به راحتی می توانید Google map را از طریق ویو پیش فرض آن به دلخواه خود در آورید و آن را طوری که مایلید تغییر دهید.

افزودن نشان گذار (Adding Marker) :

شما می توانید یک نشان گذار (علامت) همراه با یک متن روی نقشه قرار دهید که نشان دهنده ی لوکیشن شما روی نقشه می باشد. این کار از طریق متد ()addMarker انجام می شود.
سینتکس آن مانند زیر می باشد :

final LatLng TutorialsPoint = new LatLng(21 , 57);
Marker TP = googleMap.addMarker(new MarkerOptions()
   .position(TutorialsPoint).title("TutorialsPoint")); 

تغییر نوع نقشه:

شما می توانید نوع نقشه را نیز تغییر دهید.
چهار نوع نقشه متفاوت وجود دارد که هر کدام ویو های متفاوتی از نقشه ارائه می دهند. این نقشه ها عبارتند از:

• Normal
• Hybrid
• Satellite
• terrain

شما می توانید از آن ها مانند زیر استفاده کنید :

googleMap.setMapType(GoogleMap.MAP_TYPE_NORMAL);
googleMap.setMapType(GoogleMap.MAP_TYPE_HYBRID);
googleMap.setMapType(GoogleMap.MAP_TYPE_SATELLITE);
googleMap.setMapType(GoogleMap.MAP_TYPE_TERRAIN);

فعال و غیرفعال کردن زوم:

شما همچنین می توانید حرکات زوم را با فراخوانی متد (setZoomControlsEnabled(boolean فعال یا غیر فعال کنید. سینتکس آن مانند زیر می باشد :

googleMap.getUiSettings().setZoomGesturesEnabled(true);

علاوه بر شخصی سازی ، متد های دیگری در کلاس Google map وجود دارد که بیشتر در امر شخصی سازی Google map کمک می کنند. لیست آن ها را می توانید در زیر ببینید :

• (addCircle(CircleOptions options : این متد ، به نقشه ، یک دایره اضافه می کند.
• (addPolygon(PolygonOptions options این متد ، به نقشه چند ضلعی اضافه می کند.
• (addTileOverlay(TileOverlayOptions options : این متد ، به نقشه tile overlay اضافه می کند.
• (animateCamera(CameraUpdate update : این متد طبق آپدیت ، با یک انیمیشن نقشه را حرکت می دهد.
• ()clear : این متد ، همه چیز را از نقشه حذف می کند.
• ()getMyLocation : این متد آخرین موقعیت نمایش داده شده ی یوزر را باز می گرداند.
• (moveCamera(CameraUpdate update این متد ، طبق دستور العمل های تعریف شده در آپدیت ، موقعیت دوربین را تغییر می دهد.
• (setTrafficEnabled(boolean enabled : این متد ترافیک لایه را خاموش یا روشن می کند.
• ( snapshot(GoogleMap.SnapshotReadyCallback callback : این متد یک عکس فوری از نقشه می گیرد.
• ()stopAnimation : این متد ، انیمیشن در حال پیشرفت دوربین را متوقف می کند.

مثال :

این مثال ، استفاده از کلاس Google map را توضیح می دهد.
این مثال ، یک اپلیکیشن  پایه ایجاد می کند که یک مسیریابی را ، روی نقشه میسر می کند.

برای آزمایش با این مثال می توانید آن را روی دستگاه واقعی یا یک شبیه ساز اجرا کنید.

یک پروژه اکتیویتی google map در زیر نشان داده شده است .

صفحه زیر را باز کرده و url  را کپی کنید و در دکمه API  پیست نمایید . مطابق تصویر زیر :

کد انتخاب شده را کپی کنید و در مرورگر پیست نمایید . مطابق تصویر زیر :

روی گزینه continue کلیک کرده و سپس Create API را انتخاب نمایید . مطابق تصویر :

محتوای فایل activity_main.xml :

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:map="http://schemas.android.com/apk/res-auto"
   xmlns:tools="http://schemas.android.com/tools"
   android:id="@+id/map"
   android:name="com.google.android.gms.maps.SupportMapFragment"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   tools:context="com.example.tutorialspoint7.myapplication.MapsActivity" />

محتوای MapActivity.java :

package com.example.tutorialspoint7.myapplication;

import android.support.v4.app.FragmentActivity;
import android.os.Bundle;

import com.google.android.gms.maps.CameraUpdateFactory;
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;

public class MapsActivity extends FragmentActivity implements OnMapReadyCallback {

   private GoogleMap mMap;

   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_maps);
      // Obtain the SupportMapFragment and get notified when the map is ready to be used.
      SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
         .findFragmentById(R.id.map);
      mapFragment.getMapAsync(this);
   }
   
   /**
      * Manipulates the map once available.
      * This callback is triggered when the map is ready to be used.
      * This is where we can add markers or lines, add listeners or move the camera.
      * In this case, we just add a marker near Sydney, Australia.
      * If Google Play services is not installed on the device. 
      * This method will only be triggered once the user has installed 
         Google Play services and returned to the app.
   */
  
   @Override
   public void onMapReady(GoogleMap googleMap) {
      mMap = googleMap;
      // Add a marker in Sydney and move the camera
      LatLng TutorialsPoint = new LatLng(21, 57);
      mMap.addMarker(new 
         MarkerOptions().position(TutorialsPoint).title("Tutorialspoint.com"));
      mMap.moveCamera(CameraUpdateFactory.newLatLng(TutorialsPoint));
   }
}

محتوای فایل AndroidManifest.xml :

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.tutorialspoint7.myapplication">

   <!--
      The ACCESS_COARSE/FINE_LOCATION permissions are not required to use
      Google Maps Android API v2, but you must specify either coarse or fine
      location permissions for the 'MyLocation' functionality. 
   -->
    
   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
   <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
   <uses-permission android:name="android.permission.INTERNET" />
   <application
      android:allowBackup="true"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:supportsRtl="true"
      android:theme="@style/AppTheme">

      <!--
         The API key for Google Maps-based APIs is defined as a string resource.
         (See the file "res/values/google_maps_api.xml").
         Note that the API key is linked to the encryption key used to sign the APK.
         You need a different API key for each encryption key, including the release key 
         that is used to sign the APK for publishing.
         You can define the keys for the debug and 
            release targets in src/debug/ and src/release/. 
      -->
      
      <meta-data
         android:name="com.google.android.geo.API_KEY"
         android:value="AIzaSyAXhBdyKxUo_cb-EkSgWJQTdqR0QjLcqes" />

      <activity
         android:name=".MapsActivity"
         android:label="@string/title_activity_maps">
         <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
      </activity>
   </application>

</manifest>

خروجی به صورت زیر خواهد بود :