مستندات جامع اندروید
نسخه 1.0.3
Jetpack Compose یک toolkit برای ساخت UI است که به ساخت UI سادگی و سرعت بخشیده است.
جهت کسب اطلاعات بیشتر در مورد Jetpack compose میتوانید به این صفحه مراجعه نمایید.
فهرست مطالب این صفحه
در این نسخه از اس دی کی نشان، امکان پیاده سازی و استفاده از نقشه در Jetpack Compose فراهم شده است.
ابتدا پس از پیاده سازی dependency های مربوط به Jetpack Compose از وجود dependency های زیر در فایل build.gradle خود مطمئن شوید:
implementation 'androidx.appcompat:appcompat:1.6.1'
implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
سپس پس از طی کردن مراحل مربوط به راه اندازی اس دی کی در صفحه شروع کار با کیت توسعه اندروید، جهت پیاده سازی نقشه نشان در این Toolkit میتوانید به صورت زیر عمل نمایید:
override fun onStart() {
super.onStart()
// Initializing user location
setContent {
MyApplicationTheme {
// A surface container using the 'background' color from the theme
Surface(
modifier = Modifier.fillMaxSize(),
color = MaterialTheme.colorScheme.background
) {
NeshanMapView(this@MainActivity)
}
}
}
}
@Composable
private fun NeshanMapView(context: Context) {
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {}
)
}
}
}
}
تابع NeshanMapView با ایجاد یک AndroidView آبجکت MapView ی نشان را به UI اضافه میکند.
ست کردن موارد پیش فرض نقشه
در صورتی که میخواهید نقشه به صورت پیش فرض دارای مقادیر دلخواه باشد، میتوانید مقادیر را در بلوک apply از MapView ست نمایید.
در مثال زیر، هنگام لود نقشه، زوم نقشه روی 13 و لایه ترافیک غیر فعال و لایه poi فعال شده است.
@Composable
private fun NeshanMapView(context: Context) {
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context).apply {
setZoom(13f, .5f)
isTrafficEnabled = false
isPoiEnabled = true
.
.
.
}
},
update = {}
)
}
}
}
}
افزودن مارکر
جهت اعمال تغییرات روی نقشه مانند افزودن مارکر، تغییر جهت نقشه، چرخاندن نقشه و … باید از Recomposition استفاده کرد. همچنین چون متغیرها داخل تابع NeshanMapView تعریف شده است، برای حفظ مقادیر قبلی هنگام recomposition باید از remember استفاده کرد.
با توجه به توضیحات بالا، نحوه افزودن مارکر در Jetpack Compose به صورت زیر است:
در مثال بالا یک نقشه و یک ElevatedButton زیر آن ایجاد شده است که با کلیک روی دکمه یک مارکر روی نقشه ایجاد میشود.
فرایند افزودن مارکر به این صورت است که پس از کلیک کاربر روی دکمه Add marker متد createMarker یک شی مارکر با مختصات مشخص ایجاد میکند و مقدار بازگشتی تابع که از نوع Marker است در متغیر marker که در فانکشن NeshanMapView ساخته شده است ریخته میشود.
متغیر markerRemember متغیری از نوع remember است که آبجکت ایجاد شده را در هر Recomposition نگهداری میکند. marker ایجاد شده به عنوان value ی markerRemember ست میشود و عملیات Recomposition انجام میشود.
هنگام اجرای Recomposition تابع NeshanMapView مجددا اجرا میشود و value ی مربوط به markerRemember در بلوک update چک میشود.
در صورتی که مقدار آن مخالف null باشد، توسط شی it که نام object نقشه افزوده شده است و متد addMarker، مارکر ایجاد شده روی نقشه اضافه میشود.
@Composable
private fun NeshanMapView(context: Context) {
var marker: Marker? = null
val markerRemember = remember { mutableStateOf(marker) }
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if (markerRemember.value != null) {
it.addMarker(markerRemember.value)
markerRemember.value = null
}
},
modifier = Modifier.weight(1f),
)
ElevatedButton(
onClick = {
marker = createMarker(context, LatLng(35.12345, 52.12345))
markerRemember.value = marker
}
) {
Text("Add marker")
}
}
}
}
}
موارد زیر را میتوان همانند روش افزودن مارکر روی نقشه اعمال کرد.
حذف مارکر
قطعه کد زیر نحوه حذف مارکر از روی نقشه را نمایش می دهد:
@Composable
private fun NeshanMapView(context: Context) {
var marker1: Marker? = null
val marker1Remember = remember { mutableStateOf(marker1) }
val removeMarker1Remember = remember { mutableStateOf(false) }
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if (marker1Remember.value != null) {
it.addMarker(marker1Remember.value)
marker1Remember.value = null
}
if(removeMarker1Remember.value){
it.removeMarker(marker1)
}
},
modifier = Modifier.weight(1f),
)
ElevatedButton(
onClick = {
marker1 = createMarker(context, LatLng(35.70204, 51.335352))
marker1Remember.value = marker1
}
) {
Text("Add marker")
}
ElevatedButton(
onClick = {
removeMarker1Remember.value = true
}
) {
Text("Remove marker")
}
}
}
}
}
در مثال بالا متغیری از نوع Marker به نام marker1 ساخته میشود. سپس یک متغیر از نوع remember برای ذخیذه سازی مقدار marker1 ساخته میشود.
متغیر removeMarker1Remember نیز از نوع remember است و برای حذف مارکر از آن استفاده میکنیم.
پس از کلیک روی دکمه Add marker، متغیر marker1 ساخته شده و به عنوان value ی متغیر marker1Remember ست میشود.
پس از ست شدن این مقدار، عملیات Recomposition به صورت اتوماتیک اتفاق می افتد و در بلوک update چک میشود که آیا مقدار value ی متغیر marker1Remember مخالف null است یا خیر که در این صورت marker1 روی نقشه اضافه میشود.
سپس پس از کلیک روی دکمه Remove marker، مقداری value ی متغیر removeMarker1Remember برابر true ست میشود و مجددا عملیات Recomposition اتفاق می افتد.
در عملیات Recomposition، در بلوک update چک میشود که آیا مقدار removeMarker1Remember برابر true است یا خیر، که در این صورت توسط شی نقشه که در اینجا it نام دارد، اقدام به حذف مارکر میکند.
رسم خط
قطعه کد زیر نحوه رسم خط روی نقشه را نمایش می دهد:
@Composable
private fun NeshanMapView(context: Context) {
var polyline: Polyline? = null
val polylineRemember = remember { mutableStateOf(polyline) }
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if(polylineRemember.value != null){
it.addPolyline(polylineRemember.value)
}
},
modifier = Modifier.weight(1f),
)
ElevatedButton(
onClick = {
polyline = createPolyline()
polylineRemember.value = polyline
}
) {
Text("Add polyline")
}
}
}
}
}
fun createPolyline(): Polyline {
var latLngs = ArrayList<LatLng>()
latLngs.add(LatLng(35.769368, 51.327650))
latLngs.add(LatLng(35.756670, 51.323889))
latLngs.add(LatLng(35.746670, 51.383889))
return Polyline(latLngs, getLineStyle())
}
fun getLineStyle(): LineStyle {
val lineStyleBuilder = LineStyleBuilder()
lineStyleBuilder.color = Color(2, 119, 189, 190)
lineStyleBuilder.width = 4f
return lineStyleBuilder.buildStyle()
}
رسم و حذف دایره
@Composable
private fun NeshanMapView(context: Context) {
var circle1: Circle? = null
val circle1Remember = remember { mutableStateOf(circle1) }
val removeCircle1Remember = remember { mutableStateOf(false) }
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if (circle1Remember.value != null) {
it.addCircle(circle1Remember.value)
circle1Remember.value = null
}
if (removeCircle1Remember.value) {
it.removeCircle(circle1)
}
},
modifier = Modifier.weight(1f),
)
ElevatedButton(
onClick = {
circle1 = createCircle(LatLng(35.70204, 51.335352),100f)
circle1Remember.value = circle1
}
) {
Text("Add circle")
}
ElevatedButton(
onClick = {
removeCircle1Remember.value = true
}
) {
Text("Remove circle")
}
}
}
}
}
fun createCircle(centerLatLng: LatLng, radius: Double): Circle {
return Circle(centerLatLng, radius, Color(2, 119, 189, 190), getLineStyle())
}
fun getLineStyle(): LineStyle {
val lineStyleBuilder = LineStyleBuilder()
lineStyleBuilder.color = Color(2, 119, 189, 190)
lineStyleBuilder.width = 4f
return lineStyleBuilder.buildStyle()
}
رسم و حذف چند ضلعی
@Composable
private fun NeshanMapView(context: Context) {
var polygon1: Polygon? = null
val polygon1Remember = remember { mutableStateOf(polygon1) }
val removePolygon1Remember = remember { mutableStateOf(false) }
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if (polygon1Remember.value != null) {
it.addPolygon(polygon1Remember.value)
polygon1Remember.value = null
}
if (removePolygon1Remember.value) {
it.removePolygon(polygon1)
}
},
modifier = Modifier.weight(1f),
)
ElevatedButton(
onClick = {
var latLngs = ArrayList<LatLng>()
latLngs.add(LatLng(35.704760, 51.333912))
latLngs.add(LatLng(35.702212, 51.340889))
latLngs.add(LatLng(35.699977, 51.336472))
latLngs.add(LatLng(35.700902, 51.330897))
polygon1 = createPolygon(latLngs)
polygon1Remember.value = polygon1
}
) {
Text("Add polygon")
}
ElevatedButton(
onClick = {
removePolygon1Remember.value = true
}
) {
Text("Remove polygon")
}
}
}
}
}
تغییر زاویه دوربین
@Composable
private fun NeshanMapView(context: Context) {
var tiltCameraAmount: Float? = null
var tiltCameraDuration: Float? = null
val tiltCameraAmountRemember = remember { mutableStateOf(tiltCameraAmount) }
val tiltCameraDurationRemember = remember { mutableStateOf(tiltCameraDuration) }
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if (tiltCameraAmountRemember.value != null && tiltCameraDurationRemember.value != null) {
it.setTilt(
tiltCameraAmountRemember.value!!,
tiltCameraDurationRemember.value!!
)
tiltCameraAmountRemember.value = null
tiltCameraDurationRemember.value = null
}
},
modifier = Modifier.weight(1f),
)
ElevatedButton(
onClick = {
tiltCameraAmount = 30f
tiltCameraDuration = .5f
tiltCameraAmountRemember.value = tiltCameraAmount
tiltCameraDurationRemember.value = tiltCameraDuration
}
) {
Text("Tilt camera")
}
}
}
}
}
تغییر جهت دوربین
@Composable
private fun NeshanMapView(context: Context) {
var cameraBearingAmount: Float? = null
var cameraBearingDuration: Float? = null
val cameraBearingAmountRemember = remember { mutableStateOf(cameraBearingAmount) }
val cameraBearingDurationRemember = remember { mutableStateOf(cameraBearingDuration) }
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if (cameraBearingAmountRemember.value != null && cameraBearingDurationRemember.value != null) {
it.setBearing(
cameraBearingAmountRemember.value!!,
cameraBearingDurationRemember.value!!
)
cameraBearingAmountRemember.value = null
cameraBearingDurationRemember.value = null
}
},
modifier = Modifier.weight(1f),
)
ElevatedButton(
onClick = {
cameraBearingAmount = 30f
cameraBearingDuration = .5f
cameraBearingAmountRemember.value = cameraBearingAmount
cameraBearingDurationRemember.value = cameraBearingDuration
}
) {
Text("Rotate camera")
}
}
}
}
}
تغییر استایل نقشه
@Composable
private fun NeshanMapView(context: Context) {
var mapStyle: Int? = null
val mapStyleRemember = remember { mutableStateOf(mapStyle) }
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if (mapStyleRemember.value != null) {
it.setMapStyle(mapStyleRemember.value!!)
}
},
modifier = Modifier.weight(1f),
)
ElevatedButton(
onClick = {
mapStyleRemember.value = NeshanMapStyle.NESHAN_NIGHT
}
) {
Text("Night style")
}
}
}
}
}
نمایش موقعیت کاربر
class UserLocationActivity : ComponentActivity() {
private val TAG: String = MainActivity::class.java.name
private val REQUEST_CODE = 123
private val UPDATE_INTERVAL_IN_MILLISECONDS: Long = 1000
private var userMarker: Marker? = null
private var addUserMarkerRemember = mutableStateOf(userMarker)
private var moveCameraLatLng: LatLng? = null
private var moveCameraState = mutableStateOf(moveCameraLatLng)
private var moveCameraDuration: Float? = null
private var moveCameraDurationState = mutableStateOf(moveCameraDuration)
private var userLocation: Location? = null
private lateinit var fusedLocationClient: FusedLocationProviderClient
private lateinit var settingsClient: SettingsClient
private lateinit var locationRequest: LocationRequest
private var locationSettingsRequest: LocationSettingsRequest? = null
private var locationCallback: LocationCallback? = null
override fun onStart() {
super.onStart()
setContent {
JetpackComposeTheme {
// A surface container using the 'background' color from the theme
Surface(
modifier = Modifier.fillMaxSize(),
color = MaterialTheme.colorScheme.background
) {
NeshanMapView(this@UserLocationActivity)
}
}
}
initLocation()
startReceivingLocationUpdates()
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
}
@Composable
private fun NeshanMapView(context: Context) {
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if (addUserMarkerRemember.value != null) {
it.addMarker(addUserMarkerRemember.value)
}
if (moveCameraState.value != null && moveCameraDurationState.value != null) {
it.moveCamera(
moveCameraState.value,
moveCameraDurationState.value!!
)
}
},
modifier = Modifier.weight(1f),
)
}
}
}
}
fun createMarker(context: Context, loc: LatLng?): Marker {
val animStBl = AnimationStyleBuilder()
animStBl.fadeAnimationType = AnimationType.ANIMATION_TYPE_SMOOTHSTEP
animStBl.sizeAnimationType = AnimationType.ANIMATION_TYPE_SPRING
animStBl.phaseInDuration = 0.5f
animStBl.phaseOutDuration = 0.5f
val animSt = animStBl.buildStyle()
val markStCr = MarkerStyleBuilder()
markStCr.size = 30f
markStCr.bitmap = BitmapUtils.createBitmapFromAndroidBitmap(
BitmapFactory.decodeResource(context.resources, R.drawable.ic_marker)
)
markStCr.animationStyle = animSt
val markSt = markStCr.buildStyle()
return Marker(loc, markSt)
}
private fun initLocation() {
fusedLocationClient = LocationServices.getFusedLocationProviderClient(this)
settingsClient = LocationServices.getSettingsClient(this)
locationCallback = object : LocationCallback() {
override fun onLocationResult(locationResult: LocationResult) {
super.onLocationResult(locationResult)
// location is received
userLocation = locationResult.lastLocation
onLocationChange()
}
}
locationRequest = LocationRequest.Builder(
Priority.PRIORITY_HIGH_ACCURACY,
UPDATE_INTERVAL_IN_MILLISECONDS
).build()
val builder = LocationSettingsRequest.Builder()
builder.addLocationRequest(locationRequest)
locationSettingsRequest = builder.build()
}
private fun startReceivingLocationUpdates() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
if (ContextCompat.checkSelfPermission(
this@UserLocationActivity,
Manifest.permission.ACCESS_FINE_LOCATION
) == PackageManager.PERMISSION_GRANTED && ContextCompat.checkSelfPermission(
this@UserLocationActivity,
Manifest.permission.ACCESS_COARSE_LOCATION
) == PackageManager.PERMISSION_GRANTED
) {
startLocationUpdates()
} else {
requestPermissions(
arrayOf(
Manifest.permission.ACCESS_FINE_LOCATION,
Manifest.permission.ACCESS_COARSE_LOCATION
), REQUEST_CODE
)
}
} else {
startLocationUpdates()
}
}
private fun startLocationUpdates() {
settingsClient
.checkLocationSettings(locationSettingsRequest!!)
.addOnSuccessListener(this, OnSuccessListener {
Log.i(
TAG,
"All location settings are satisfied."
)
if (ContextCompat.checkSelfPermission(
this@UserLocationActivity,
Manifest.permission.ACCESS_FINE_LOCATION
) != PackageManager.PERMISSION_GRANTED && ContextCompat.checkSelfPermission(
this@UserLocationActivity,
Manifest.permission.ACCESS_COARSE_LOCATION
) != PackageManager.PERMISSION_GRANTED
) {
Log.d("UserLocationUpdater", " required permissions are not granted ")
return@OnSuccessListener
}
fusedLocationClient.requestLocationUpdates(
locationRequest,
locationCallback!!,
Looper.myLooper()
)
})
.addOnFailureListener(this) { e ->
val statusCode = (e as ApiException).statusCode
when (statusCode) {
LocationSettingsStatusCodes.RESOLUTION_REQUIRED -> try {
Log.i(
TAG,
"Location settings are not satisfied. Attempting to upgrade location settings"
)
// Show the dialog by calling startResolutionForResult(), and check the
// result in onActivityResult().
val rae = e as ResolvableApiException
rae.startResolutionForResult(this@UserLocationActivity, REQUEST_CODE)
} catch (sie: IntentSender.SendIntentException) {
Log.i(
TAG,
"PendingIntent unable to execute request."
)
}
LocationSettingsStatusCodes.SETTINGS_CHANGE_UNAVAILABLE -> {
val errorMessage =
"Location settings are inadequate, and cannot be fixed here. Fix in Settings."
Log.e(
TAG,
errorMessage
)
Toast.makeText(this@UserLocationActivity, errorMessage, Toast.LENGTH_LONG)
.show()
}
}
}
}
private fun onLocationChange() {
if (userLocation != null) {
stopLocationUpdates()
var marker: Marker = createMarker(
this@UserLocationActivity,
LatLng(userLocation!!.latitude, userLocation!!.longitude)
)
addUserMarkerRemember.value = marker
moveCameraState.value = LatLng(userLocation!!.latitude, userLocation!!.longitude)
moveCameraDurationState.value = .5f
}
}
private fun stopLocationUpdates() {
// Removing location updates
fusedLocationClient
.removeLocationUpdates(locationCallback!!)
.addOnCompleteListener(
this
) {
Toast.makeText(applicationContext, "Location updates stopped!", Toast.LENGTH_SHORT)
.show()
}
}
}
در مثال بالا علاوه بر پیاده سازی نحوه نمایش موقعیت کاربر، نحوه حرکت دادن دوربین را نیز پیاده سازی کرده ایم.
متغیرهای moveCameraLatLng ، moveCameraDuration ، moveCameraState و moveCameraDurationState برای حرکت دادن دوربین مورد استفاده قرار میگیرند.
فعالسازی لایه ترافیک
@Composable
private fun NeshanMapView(context: Context) {
val trafficLayerRemember = remember { mutableStateOf(false) }
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if (trafficLayerRemember.value != null) {
it.setTrafficEnabled(trafficLayerRemember.value)
}
},
modifier = Modifier.weight(1f),
)
ElevatedButton(
onClick = {
trafficLayerRemember.value = !trafficLayerRemember.value
}
) {
Text("Toggle traffic layer")
}
}
}
}
}
فعالسازی لایه poi
@Composable
private fun NeshanMapView(context: Context) {
val poiLayerRemember = remember { mutableStateOf(false) }
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if (poiLayerRemember.value != null) {
it.setPoiEnabled(poiLayerRemember.value)
}
},
modifier = Modifier.weight(1f),
)
ElevatedButton(
onClick = {
poiLayerRemember.value = !poiLayerRemember.value
}
) {
Text("Toggle poi layer")
}
}
}
}
}
افزودن برچسب
@Composable
private fun NeshanMapView(context: Context) {
var label1:Label? = null
val addLabel1Remember = remember { mutableStateOf(label1) }
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if (addLabel1Remember.value != null) {
it.addLabel(addLabel1Remember.value)
}
},
modifier = Modifier.weight(1f),
)
ElevatedButton(
onClick = {
addLabel1Remember.value = createLabel(LatLng(35.700476, 51.337644),"Label1 caption")
}
) {
Text("Add label")
}
}
}
}
}
خوشه بندی نشانگرها
@Composable
private fun NeshanMapView(context: Context) {
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context).apply {
settings.isMarkerClusteringEnabled = true
}
},
update = {
},
modifier = Modifier.weight(1f),
)
}
}
}
}
متدهای کار با دوربین
جهت آشنایی با متدهای کار با دوربین روی نقشه میتوانید به صفحه متدهای کار با دوربین مراجعه نمایید.
در ادامه نحوه پیاده سازی این متدها در Jetpack Compose را شرح میدهیم:
متد moveToCameraBounds
@Composable
private fun NeshanMapView(context: Context) {
var moveToCameraBoundsNorthEast: LatLng? = null
var moveToCameraBoundsSouthWest: LatLng? = null
var moveToCameraBoundsintegerZoom: Boolean? = null
var moveToCameraBoundsDuration: Float? = null
val moveToCameraBoundsNorthEastRemember =
remember { mutableStateOf(moveToCameraBoundsNorthEast) }
val moveToCameraBoundsSouthWestRemember =
remember { mutableStateOf(moveToCameraBoundsSouthWest) }
val moveToCameraBoundsIntegerZoomRemember =
remember { mutableStateOf(moveToCameraBoundsintegerZoom) }
val moveToCameraBoundsDurationRemember =
remember { mutableStateOf(moveToCameraBoundsDuration) }
var moveCameraLatLng: LatLng? = null
var moveCameraDuration: Float? = null
val moveCameraRemember = remember { mutableStateOf(moveCameraLatLng) }
val moveCameraDurationRemember = remember { mutableStateOf(moveCameraDuration) }
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if (moveCameraRemember.value != null && moveCameraDurationRemember.value != null) {
it.moveCamera(
moveCameraRemember.value,
moveCameraDurationRemember.value!!
)
}
if (moveToCameraBoundsNorthEastRemember.value != null
&& moveToCameraBoundsSouthWestRemember.value != null
&& moveToCameraBoundsIntegerZoomRemember.value != null
&& moveToCameraBoundsDurationRemember.value != null
) {
it.moveToCameraBounds(
LatLngBounds(
moveToCameraBoundsNorthEastRemember.value,
moveToCameraBoundsSouthWestRemember.value
),
ScreenBounds(
ScreenPos(0f, 0f),
ScreenPos(it.width.toFloat(), it.height.toFloat())
),
moveToCameraBoundsIntegerZoomRemember.value!!,
moveToCameraBoundsDurationRemember.value!!
)
}
},
modifier = Modifier.weight(1f),
)
ElevatedButton(
onClick = {
moveCameraLatLng = LatLng(36.316203, 59.576074)
moveCameraDuration = .5f
moveCameraRemember.value = moveCameraLatLng
moveCameraDurationRemember.value = moveCameraDuration
}
) {
Text("Move camera")
}
ElevatedButton(
onClick = {
moveToCameraBoundsNorthEast =
LatLng(35.809174301661336, 51.53005019022984)
moveToCameraBoundsSouthWest =
LatLng(35.61431826413479, 51.137353382540034)
moveToCameraBoundsintegerZoom = false
moveToCameraBoundsDuration = .5f
moveToCameraBoundsNorthEastRemember.value = moveToCameraBoundsNorthEast
moveToCameraBoundsSouthWestRemember.value = moveToCameraBoundsSouthWest
moveToCameraBoundsDurationRemember.value = moveToCameraBoundsDuration
moveToCameraBoundsIntegerZoomRemember.value =
moveToCameraBoundsintegerZoom
}
) {
Text("MoveToCameraBounds method test")
}
}
}
}
}
متد moveCamera
@Composable
private fun NeshanMapView(context: Context) {
var moveCameraLatLng: LatLng? = null
var moveCameraDuration: Float? = null
val moveCameraRemember = remember { mutableStateOf(moveCameraLatLng) }
val moveCameraDurationRemember = remember { mutableStateOf(moveCameraDuration) }
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context) as View
},
update = {
if (moveCameraRemember.value != null && moveCameraDurationRemember.value != null) {
it.moveCamera(
moveCameraRemember.value,
moveCameraDurationRemember.value!!
)
}
},
modifier = Modifier.weight(1f),
)
ElevatedButton(
onClick = {
moveCameraLatLng = LatLng(35.701519, 51.337244)
moveCameraDuration = .5f
moveCameraRemember.value = moveCameraLatLng
moveCameraDurationRemember.value = moveCameraDuration
}
) {
Text("Move camera")
}
}
}
}
}
متغیر cameraTargetPosition
برای دسترسی به نقطه وسط نقشه نیز میتوانید در بلوک های factory و update به صورت زیر دسترسی داشته باشید:
@Composable
private fun NeshanMapView(context: Context) {
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context).apply{
cameraTargetPosition
}
},
update = {
it.cameraTargetPosition
},
modifier = Modifier.weight(1f),
)
}
}
}
}
لیسنرها
setOnCameraMoveListener
setOnCameraMoveStartListener
setOnCameraMoveFinishedListener
@Composable
private fun NeshanMapView(context: Context) {
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context).apply{
setOnCameraMoveListener {
//Do someting...
}
setOnCameraMoveStartListener {
//Do something
}
setOnCameraMoveFinishedListener {
//Do something
}
}
},
update = {
},
modifier = Modifier.weight(1f),
)
}
}
}
}
setOnMarkerClickListener
setOnCircleClickListener
setOnPolygonClickListener
setOnPolylineClickListener
@Composable
private fun NeshanMapView(context: Context) {
Surface() {
Row() {
Column() {
AndroidView(
factory = { context ->
MapView(context).apply {
setOnMarkerClickListener {
//Do something
}
setOnPolylineClickListener {
//Do something
}
setOnPolygonClickListener {
//Do something
}
setOnCircleClickListener {
//Do something
}
}
},
update = {
},
modifier = Modifier.weight(1f),
)
}
}
}
}