آموزش سرویسهای مبتنی بر موقعیت Location Based در اندروید

سلام به شما دوستای خوب و عزیز با آ موزش سرویسهای مبتنی بر موقعیت Location Based در اندروید در خدمتش ما هستم .

Android Location Based Services

API های لوکیشن اندروید بدون اینکه نیاز باشد به جزئیات مربوط به فن آوری مکان تمرکز کنیم ساخت برنامه های مکان نما را برایمان آسان می کنند، . این امر با کمک خدمات Google Play امکان پذیر می شود، که افزودن آگاهی از موقعیت را با تقسیم بندی خودکار موقعیت، geofencingو شناسایی فعالیت آسان می کند.

این آموزش به شما نشان می دهد که چگونه از خدمات مکانی در برنامه ی خود استفاده کنید تا مکان کنونی و آپدیت های دوره ای موقعیت را بگیرید و یا چگونه به دنبال آدرس ها بگردید و غیره.

آبجکت موقعیت

آبجکت موقعیت نشان می دهد که یک موقعیت جغرافیایی می تواند شامل عرض جغرافیایی، طول جغرافیایی و جدول زمانی و دیگر اطلاعات مانند جهت و ارتفاع باشد. در زیر روش های مهمی وجود دارند که می توانید با آبجکت موقعیت برای گرفتن اطلاعات یک مکان خاص از آنها استفاده کنید.

S.N.

متدها و توصیفات

۱

float distanceTo(Location dest)

مسافت بین این موقعیت و موقعیت داده شده را به متر برمی گرداند.

۲

float getAccuracy()

صحت تقریبی این موقعیت را به متر به دست می آورد.

۳

double getAltitude()

ارتفاع از سطح دریا را، اگر در دسترس باشد، به دست می آورد.

۴

float getBearing()

جهت را به درجه به دست می آورد.

۵

double getLatitude()

عرض جغرافیایی را به درجه به دست می آورد.

۶

double getLongitude()
طول جغرافیایی را به درجه به دست می آورد.

۷

float getSpeed()

سرعت را اگر در دسترس باشد، در متر بر ثانیه به دست می آورد.

۸

boolean hasAccuracy()

درست، اگر این موقعیت درست باشد.

۹

boolean hasAltitude()

درست، اگر این موقعیت دارای ارتفاع باشد.

۱۰

boolean hasBearing()

درست، اگر این موقعیت دارای جهت باشد.

۱۱

boolean hasSpeed()

درست، اگر این موقعیت دارای سرعت باشد.

۱۲

void reset()

محتوای مربوط به موقعیت را واضح می کند.

۱۳

void setAccuracy(float accuracy)

درستی برآورد شده ی این موقعیت را به متر تنظیم می کند.

۱۴

void setAltitude(double altitude)

ارتفاع را از سطح دریا به متر تنظیم می کند.

۱۵

void setBearing(float bearing)

جهت را به درجه تنظیم می کند.

۱۶

void setLatitude(double latitude)

عرض جغرافیایی را به درجه تنظیم می کند.

۱۷

void setLongitude(double longitude)

طول جغرافیایی را به درجه تنظیم می کند.

۱۸

void setSpeed(float speed)

سرعت را به متر برثانیه در سطح زمین تنظیم می کند.

۱۹

String toString()

یک رشته شامل توصیفات فشرده و خوانا از این آبجکت را برمی گرداند.

به دست آوردن موقعیت کنونی

برای به دست آوردن موقعیت کنونی یک موقعیت کابر ایجاد کنید که آبجکت LocationClient می باشد و با استفاده از روش connect() به خدمات موقعیت (Location Services) متصل شوید و سپس روش getLastLocation() آن را فرا بخوانید. این روش آخرین موقعیت را به فرم آبجکت موقعیت برمی گرداند که شامل مختصات طول و عرض جغرافیایی و دیگر اطلاعاتی که در بالا توضیح داده شد، می باشد. برای داشتن کاربرد موقعیت محور در فعالیت خود، باید دو اینترفیس را اجرا کنید.

‎GooglePlayServicesClient.ConnectionCallbacks ‎
GooglePlayServicesClient.OnConnectionFailedListener

این اینترفیس ها روش های مهم call back را ارائه می دهند که شما برای اجرای فعالیت گروه خود نیاز دارید. برخی از این روش های مهم عبارتند از

S.N.

Callback Methods & Description

۱

abstract void onConnected(Bundle connectionHint)

این روش کال بک زمانی فراخوانده می شود که سرویس موقعیت به موقعیت کابر به طور موفقیت آمیزی متصل شود. شما از روش connect() برای اتصال به موقعیت کاربر استفاده خواهید کرد.

۲

abstract void onDisconnected()

این روش کال بک زمانی فراخوانده می شود که اتصال کاربرقطع شده باشد. شما از روش disconnect() برای قطع شدن از موقعیت کاربر استفاده خواهید کرد.

۳

abstract void onConnectionFailed(ConnectionResult result)

این روش کال بک زمانی استفاده می شود که در برقراری ارتباط بین کاربر و سرویس خطا وجود داشته باشد.

شما باید در روش onCreate() از فعالیت گروه خود یک موقعیت کاربر ایجاد کنید، سپس آن را به onStart() متصل کنید، طوری که سرویس های موقعیت در هنگامی که فعالیت شما به طور کامل قابل مشاهده است، موقعیت کنونی را نشان دهد. شما باید کاربر را در روش onStop() قطع کنید، طوری که وقتی برنامه ی شما قابل مشاهده نیست، سرویس های موقعیت، موقعیت کنونی را حفظ نکنند. این عمر به حفظ توان باتری برای مدت طولانی کمک می کند.

گرفتن Updated Location

اگر قادر هستید که آپدیت های موقعیت را داشته باشید، علاوه بر اینترفیس های ذکر شده در بالا، لازم است که اینترفیس LocationListener را نیز اجرا کنید. این اینترفیس روش کال بک زیر را ارائه می دهدکه شما برای اجرای فعالیت گروه خود به آن نیاز دارید.

S.N.

Callback Method & Description

۱

abstract void onLocationChanged(Location location)

این روش کال بک برای دریافت اطلاعیه ها از Location Client زمانی که موقعیت عوض شده، استفاده می شود.

کیفیت موقعیت سرویس(Location Quality of Service)

آبجکت LocationRequest برای درخواست کیفیت سرویس (QoS) برای آپدیت های موقعیت از LocationClient استفاده می شود. متودهای آراینده ای وجود دارند که برای رسیدگی به QoS مفید می باشند و در زیر ارائه شده اند. همچنین روش های گیرنده ی هم ارزی وجود که می توانید در اطلاعات رسمی اندروید آنها را چک کنید.

S.N.

Method & Description

۱

setExpirationDuration(long millis)

زمان این تقاضا را به میلی ثانیه تنظیم می کند.

۲

setExpirationTime(long millis)

زمان انقضای تقاضا را از زمان بوت به میلی ثانیه تنظیم می کند.

۳

setFastestInterval(long millis)

واضحا سریعترین وقفه را برای آپدیت های موقعیت به میلی ثانیه تنظیم می کند.

۴

setInterval(long millis)

وقفه ی درخواستی را برای آپدیت های موقعیت فعال به میلی ثانیه تنظیم می کند.

۵

setNumUpdates(int numUpdates)

تعداد آپدیت های موقعیت را تنظیم می کند.

۶

setPriority(int priority)

اولویت درخواست را تنظیم می کند.

اکنون به عنوان مثال اگر برنامه ی شما یک موقعیت با میزان درستی خیلی بالا می خواهد، باید یک درخواست موقعیت با setPriority(int) ایجاد کند، برروی PRIORITY_HIGH_ACCURACY تنظیم کرده و setInterval(long) را روی ۵ ثانیه تنظیم کند. همچنین می توانید از وقفه های بزرگتر استفاده کنید و یا از دیگر اولویت ها مانند PRIORITY_LOW_POWER برای صحت در سطح شهر و یا PRIORITY_BALANCED_POWER_ACCURACY برای صحت در سطح بلوک.

فعالیت ها باید توجه داشته باشند که در هنگام ورود زمینه تمام درخواست های موقعیت را حذف کنند (برای مثال در onPause()) یا حداقل درخواست را به یک وقفه ی طولانی تر و کیفیت پایین تر تغییر دهند تا مصرف نیروی باتری را ذخیره کنند.

نمایش آدرس یک موقعیت

زمانی که شما آبجکت موقعیت را دارید می توانید از روش Geocoder.getFromLocation() استفاده کنید تا یک آدرس را برای طول و عرض جغرافایی داده شده به دست آورید. این روش یک روش همزمان (synchronous) می باشد و ممکن است انجام کار آن زمان زیادی بگیرد، بنابراین شما باید روش را از روش doInBackground() از یک گروه AsyncTask فرا بخوانید.

AsyncTask برای استفاده باید به زیرگروه هایی تقسیم شود، و زیر گروه روش doInBackground(Params…) را طی می کند تا یک عمل را در زمینه انجام دهد، و پس ازاینکه شمارگری روی زمینه تمام می شود و زمان نمایش نتیجه می باشد، روش onPostExecute(Result) روی رشته یUI درخواست می شود. یک روش مهم دیگر هم در AyncTask وجود دارد که execute(Params… params) می باشد، این روش کار را با پارامترهای خاصی انجام می دهد.

مثال زیر را بررسی کنید تا درک بهتری از چگونگی استفاده از AynchTask در هر برنامه ی اندروید داشته باشید. مثال زیر در عمل به شما نشان می دهد که چگونه از Location Services در برنامه ی خود استفاده کنید تا موقعیت کنونی و آدرس مربوطبه آن و غیره را به دست آورید.

برای آرمایش با ابن مثال شما به یک موبایل مجهز شده به آخرین نسخه ی Android OS نیاز خواهید داشت. در غیر این صورت مجبورخواهید بود تلاش خود را با مقلدی انجام دهید که ممکن است به درستی کار نکند.

نصب سرویس های Google play SDK

قبل از اینکه جلوتر بروید تا حمایت موقعیت ها را در برنامه های اندروید خود داشته باشید، لازم است تا خدمات Google Play SDK را با استفاده از مراحل ساده ی زیر، نصب کنید.

Steps

Description

۱

آغاز گرداننده ی SDK:

· از Eclipse (با ADT) عبارت Window > Android SDK Manager را انتخاب کنید.

· در ویندوز روی فایل SDK Manager.exe در روت از مسیر Android SDK دابل کلیک کنید.

· روی Mac یا Linux یک پایانه باز کنید و به tools/directory در مسیر Android SDK مسیریابی کنید و سپس android sdk را اجرا کنید.

۲

گزینه ی Google Play services را از لیست پکیج ارائه شده در زیر Extra جستجو کنید و اگر نصب نشده است، آن را نصب کنید. خدمات Google Play SDK در محیط Android SDK شما در <android-sdk>/extras/google/google_play_services/ ذخیره می شود.

۳

پروژه ی کتابخانه را درموقعیت <android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/ کپی کنید، جایی که شما برنامه های اندروید خود را نگهداری می کنید. اگر شما در حال استفاده از Eclip هستید، برنامه ی کتابخانه را وارد فضای کار خود کنید. روی File > Import کلیک کنید و Android > Existing Android Code into Workspace را انتخاب کنید و در <android-sdk>/extras/google/google_play_services/libproject/ برنامه ی کتابخانه فهرست کنید تا وارد شود.

ایجاد برنامه ی اندروید

مراحل

توضیحات

۱

شما از Eclipse IDE برای ایجاد برنامه ی اندروید استفاده خواهید کرد وآن را زیر بسته ی com.example.lbsdemo به عنوان LBSDemo/i> نامگذاری کنید. هنگام ایجاد این برنامه مطمئن شوید که SDK وCompile را با آخرین ورژن اندروید SDK هدف قرار داده اید تا از سطوح بالاتر API استفاده کنید.

۲

کتابخانه Google play Service را با دنبال کردن مراحل ساده ی زیر، به برنامه ی خود اضافه کنید.

۳

فایل src/MainActivity.java را تا حدی تغییر دهید و کدهای لازم را به آن اضافه کنید، همانطور که در زیر نشان داده شده است، تا از موقعیت کنونی به دست آمده و آدرس های هم تراز آن نگهداری کنید.

۴

فایل نمایه ی XML را به res/layout/activity_main.xml تغییر دهید تا تمام مولفه های GUI را به آن بیفزایید که شامل سه دکمه و دو ویو متن می باشد تا موقعیت یا آدرس را نمایش دهد.

۵

res/values/strings.xml را تغییر دهید تا مقادیر ثابت لتزم را تعریف کنید.

۶

AndroidManifest.xml را به شکلی که در زیر نشان داده شده تغییر دهید.

۷

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

اجازه دهید مرجع Google Play Service را در برنامه اضافه کنیم. روی برنامه راست کلیک کنید و Build Path > Configure Build Path > Android > را انتخاب کنید و سپس دکمه ی Add را کلیک کنید که گزینه ی google-play-service_lib اضافه شدن نشان خواهد داد. فقط روی آن دابل کلیک کنید که مرجع مورد نیاز کتابخانه را اضافه خواهد کرد و شما پنجره را به شکل زیر خواهید داشت.

در زیر محتوای فعالیت اصلی فایل اصلح شده را می بینید.

package com.example.lbsdemo;
import java.io.IOException;
import java.util.List;
import java.util.Locale;
import com.google.android.gms.common.ConnectionResult;
import com.google.android.gms.common.GooglePlayServicesClient;
import com.google.android.gms.location.LocationClient;
import android.content.Context;
import android.location.Address;
import android.location.Geocoder;
import android.location.Location;
import android.os.AsyncTask;
import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
import android.widget.Toast;
public class MainActivity extends FragmentActivity implements
GooglePlayServicesClient.ConnectionCallbacks,
GooglePlayServicesClient.OnConnectionFailedListener
{
LocationClient mLocationClient;
private TextView addressLabel;
private TextView locationLabel;
private Button getLocationBtn;
private Button disconnectBtn;
private Button connectBtn;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
locationLabel = (TextView) findViewById(R.id.locationLabel);
addressLabel = (TextView) findViewById(R.id.addressLabel); getLocationBtn = (Button) findViewById(R.id.getLocation);
getLocationBtn.setOnClickListener(new View.OnClickListener() {
public void onClick(View view) {
displayCurrentLocation();
}
});
disconnectBtn = (Button) findViewById(R.id.disconnect);
disconnectBtn.setOnClickListener(new View.OnClickListener() {
public void onClick(View view) {
mLocationClient.disconnect();
locationLabel.setText(“Got disconnected….”);
}
});
connectBtn = (Button) findViewById(R.id.connect);
connectBtn.setOnClickListener(new View.OnClickListener() { public void onClick(View view) {
mLocationClient.connect();
locationLabel.setText(“Got connected….”);
}
});
// Create the LocationRequest object
mLocationClient = new LocationClient(this, this, this);
}
@Override
protected void onStart() {
super.onStart();
// Connect the client.
mLocationClient.connect();
locationLabel.setText(“Got connected….”);
}
@Override
protected void onStop() {
// Disconnect the client.
mLocationClient.disconnect();
super.onStop();
locationLabel.setText(“Got disconnected….”);
}
@Override
public void onConnected(Bundle dataBundle) {
// Display the connection status
Toast.makeText(this, “Connected”, Toast.LENGTH_SHORT).show();
}
@Override
public void onDisconnected() {
// Display the connection status
Toast.makeText(this, “Disconnected. Please re-connect.”,
Toast.LENGTH_SHORT).show();
}
@Override
public void onConnectionFailed(ConnectionResult connectionResult) {
// Display the error code on failure
Toast.makeText(this, “Connection Failure : ” +
connectionResult.getErrorCode(),
Toast.LENGTH_SHORT).show();
}
public void displayCurrentLocation() {
// Get the current location’s latitude & longitude
Location currentLocation = mLocationClient.getLastLocation();
String msg = “Current Location: ” +
Double.toString(currentLocation.getLatitude()) + “,” +
Double.toString(currentLocation.getLongitude());
// Display the current location in the UI
locationLabel.setText(msg);
// To display the current address in the UI
(new GetAddressTask(this)).execute(currentLocation);
}
/*
* Following is a subclass of AsyncTask which has been used to get
* address corresponding to the given latitude & longitude.
*/
private class GetAddressTask extends AsyncTask{
Context mContext;
public GetAddressTask(Context context) {
super();
mContext = context;
}

/*
* When the task finishes, onPostExecute() displays the address.
*/
@Override
protected void onPostExecute(String address) {
// Display the current address in the UI
addressLabel.setText(address);
}
@Override
protected String doInBackground(Location… params) {
Geocoder geocoder =
new Geocoder(mContext, Locale.getDefault());
// Get the current location from the input parameter list
Location loc = params[0];
// Create a list to contain the result address
List