บทนำ
ตัวอย่างนี้แสดงวิธีแปลงที่อยู่ (Address) เป็นพิกัดละติจูดและลองจิจูด (Geocoding) โดยใช้ Geocoder API ใน Android
ขั้นตอนที่ 1: สร้างโปรเจกต์
สร้างโปรเจกต์ใหม่ใน Android Studio ตามปกติ
ขั้นตอนที่ 2: Layout สำหรับป้อนที่อยู่ (activity_main.xml)
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:tools="https://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:padding="8dp"
tools:context=".MainActivity">
<TextView
android:id="@+id/textViewAddress"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentStart="true"
android:text="Enter Address: "
android:textAppearance="?android:attr/textAppearanceMedium"
android:textStyle="bold" />
<EditText
android:id="@+id/editTextAddress"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_alignParentTop="true"
android:layout_toEndOf="@id/textViewAddress"
android:singleLine="true" />
<Button
android:id="@+id/addressButton"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_below="@id/textViewAddress"
android:layout_marginTop="50dp"
android:layout_toEndOf="@id/textViewAddress"
android:text="Show Lat/Long" />
<TextView
android:id="@+id/latLongTV"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerVertical="true"
android:layout_toEndOf="@id/textViewAddress"
android:textAppearance="?android:attr/textAppearanceLarge"
android:textColor="@android:color/background_dark" />
</RelativeLayout>
ขั้นตอนที่ 3: MainActivity.kt
import android.os.Bundle
import android.os.Handler
import android.os.Message
import android.widget.Button
import android.widget.EditText
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
private lateinit var addressButton: Button
private lateinit var textViewAddress: TextView
private lateinit var textViewLatLong: TextView
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
title = "Geocoding Demo"
textViewAddress = findViewById(R.id.textViewAddress)
textViewLatLong = findViewById(R.id.latLongTV)
addressButton = findViewById(R.id.addressButton)
addressButton.setOnClickListener {
val editText = findViewById<EditText>(R.id.editTextAddress)
val address = editText.text.toString()
val geoCoding = GeoCodingLocation()
geoCoding.getAddressFromLocation(address, applicationContext, GeoCoderHandler(this))
}
}
companion object {
private class GeoCoderHandler(private val mainActivity: MainActivity) : Handler() {
override fun handleMessage(message: Message) {
val locationAddress = when (message.what) {
1 -> {
val bundle = message.data
bundle.getString("address")
}
else -> null
}
mainActivity.textViewLatLong.text = locationAddress
}
}
}
}
ขั้นตอนที่ 4: คลาส GeoCodingLocation.kt
import android.content.Context
import android.location.Address
import android.location.Geocoder
import android.os.Bundle
import android.os.Handler
import android.os.Message
import android.util.Log
import java.io.IOException
import java.util.Locale
class GeoCodingLocation {
private val TAG = "GeoCodeLocation"
fun getAddressFromLocation(locationAddress: String, context: Context, handler: Handler) {
val thread = object : Thread() {
override fun run() {
val geoCoder = Geocoder(context, Locale.getDefault())
var result: String? = null
try {
val addressList = geoCoder.getFromLocationName(locationAddress, 1)
if (addressList != null && addressList.size > 0) {
val address = addressList[0]
val sb = StringBuilder()
sb.append("Latitude: ").append(address.latitude).append("\n")
sb.append("Longitude: ").append(address.longitude).append("\n")
result = sb.toString()
}
} catch (e: IOException) {
Log.e(TAG, "Unable to connect to GeoCoder", e)
} finally {
val message = Message.obtain()
message.target = handler
message.what = 1
val bundle = Bundle()
result = "Address: $locationAddress\n\nLatitude and Longitude:\n$result"
bundle.putString("address", result)
message.data = bundle
message.sendToTarget()
}
}
}
thread.start()
}
}
ขั้นตอนที่ 5: Manifest (ต้องเพิ่ม Permission)
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
package="com.example.geocoding">
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
หมายเหตุสำคัญ
- ต้องมีการเชื่อมต่ออินเทอร์เน็ตเพื่อใช้ Geocoder
- ควรทดสอบบนอุปกรณ์จริง เนื่องจาก Emulator อาจไม่รองรับ Geocoder ได้เต็มที่
- API นี้มีข้อจำกัดเรื่องอัตราการเรียกใช้ (Rate limiting)