سرویس تبدیل آدرس به نقطه جغرافیایی (جئوکدینگ) – B4A

Android SDK Resources

هدف از این بخش از پروژه، استفاده از وب سرویس تبدیل آدرس به نقطه جغرافیایی (GeoCoding) در B4A است.

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

کتابخانه های مورد نیاز

برای پیاده سازی این سرویس باید کتابخانه زیر را در پنجره Libraries Manager تیک بزنید:

  • JavaObject

وب سرویس

برای آشنایی سریع با وب سرویس جئوکدینگ نشان، میتوانید از لینک زیر استفاده کنید:

وب سرویس جئوکدینگ

 

نمونه ای از پاسخ دریافت شده از سرویس جئوکدینگ به صورت زیر می باشد:

            {
    "location": {
        "x": 59.58030012321334,
        "y": 36.30608816378243
    },
    "status": "OK"
}
        

پیاده سازی

به منظور استفاده از سرویس های نشان، شما باید یک Api-Key در پنل توسعه دهندگان نشان ایجاد کرده و از آن در ارسال سرویس استفاده کنید.

در فایل Main پروژه در قسمت Region Project Attributes خطوط زیر را اضافه کنید:

#AdditionalJar: common-release.aar
#AdditionalJar: gson-2.8.5.jar

جهت صدا زدن سرویس جئوکدینگ از طریق اس دی کی B4A نشان میتوانید از متد neshanGeocoding به صورت زیر استفاده کنید:

            NeshanMapSdk1.neshanGeocoding(API-KEY(String),address(String))
        

پارامترها:

API-KEY: کلید دسترسی از نوع string که در پنل توسعه دهندگان ایجاد کرده اید.

addressعبارت جستجو

پس از صدا زدن این سرویس، خروجی توسط متد geocodingResultReceived دریافت میشود.

جهت دریافت خروجی، متد geocodingResultReceived را در اکتیویتی خود به صورت زیر پیاده سازی کنید:

            Sub geocodingResultReceived(gecodingResult As Object)
	
End Sub
        

در صورتی که سرویس به هر دلیلی با خطا مواجه شود، متد geocodingResultReceivingError صدا زده خواهد شد.

بنابراین در اکتیویتی خود، متد geocodingResultReceivingError را برای دریافت خطا به صورت زیر پیاده سازی کنید.

            Sub geocodingResultReceivingError(errorObject As Object)
	
End Sub
        

متغیر errorObject حاوی خطایی است که از سمت سرویس برگردانده شده است.

در صورتی که سرویس با خطا مواجه نشود، متغیر geocodingResult در متد geocodingResultReceived حاوی خروجی سرویس جئوکدینگ خواهد بود.

بر اساس خروجی سرویس که یک جیسون با ساختاری است که پیش تر به آن اشاره شد، توسط یک شی JavaObject میتوان مقادیر را به صورت زیر از آن استخراج کرد.

            Sub geocodingResultReceived(gecodingResult As Object)
	Private geocodingResultJO As JavaObject = gecodingResult
	Log(geocodingResultJO.GetField("gCStatus"))
	Private lat As Double = geocodingResultJO.GetFieldJO("gCLocation").GetField("gCLocationLatitude")
	Private lng As Double = geocodingResultJO.GetFieldJO("gCLocation").GetField("gCLocationLongitude")
	Log(lat)
	Log(lng)
End Sub
        

در مثال بالا ابتدا خروجی سرویس که در متغیر geocodingResult است داخل یک متغیر از نوع JavaObject به نام geocodingResultJO ریخته میشود. با این کار متغیر geocodingResult تبدیل به یک متغیر از نوع JavaObject شده و داخل متغیر geocodingResultJO قرار میگیرد.

سپس از طریق متد GetField و GetFieldJO و نام فیلدهای ذکر شده که در قسمت نام فیلدها به صورت کامل آورده شده است، میتوان به مقادیر خروجی سرویس دسترسی داشت.

مثال بالا مقادیر مربوط به خروجی سرویس را استخراج کرده و آنها را Log میکند.

نحوه نام گذاری فیلدهای مربوط به هر سرویس به این صورت است که ابتدا حروف ابتدایی نام سرویس مورد نظر به صورت camel case آورده شده سپس نام فیلد پس از آن قرار میگیرد.

در تکه کد بالا همانطور که نام سرویس geocoding است، ابتدای فیلدها حروف gC به صورت camel case قرار گرفته است.

 

نام فیلدها:

نام فیلد در سرویس

            location
	x
	y
status
        

نام فیلد در اس دی کی

            gCLocation
	gCLocationLongitude
	gCLocationLatitude
gCStatus
        
فهرست مطالب این صفحه