Location Data

คุณลักษณะที่โดดเด่นอย่างหนึ่งของแอปพลิเคชันบนอุปกรณ์เคลื่อนที่คือการรับรู้ตำแหน่ง ผู้ใช้อุปกรณ์เคลื่อนที่จะนำอุปกรณ์ของตนไปด้วยทุกที่ และการเพิ่มการรับรู้ตำแหน่งลงในแอปช่วยให้ผู้ใช้ได้รับประสบการณ์การใช้งานตามบริบทมากขึ้น

ตัวอย่างโค้ด

ที่เก็บ ApiDemos ใน GitHub มีตัวอย่างที่สาธิตการใช้ตำแหน่งในแผนที่ ดังนี้

Kotlin

• MyLocationDemoActivity: การใช้เลเยอร์ตำแหน่งของฉัน รวมถึงสิทธิ์รันไทม์
• LocationSourceDemoActivity: การใช้ LocationSource ที่กำหนดเอง
• CurrentPlaceDetailsOnMap: การค้นหาตำแหน่งปัจจุบันของอุปกรณ์ Android และการแสดงรายละเอียดของสถานที่ (ธุรกิจหรือจุดที่น่าสนใจอื่นๆ) ในตำแหน่งนั้น ดูบทแนะนำเกี่ยวกับการแสดง รายละเอียดสถานที่ปัจจุบันบนแผนที่

Java

• MyLocationDemoActivity: การใช้เลเยอร์ตำแหน่งของฉัน รวมถึงสิทธิ์รันไทม์
• LocationSourceDemoActivity: การใช้ LocationSource ที่กำหนดเอง
• CurrentPlaceDetailsOnMap: การค้นหาตำแหน่งปัจจุบันของอุปกรณ์ Android และการแสดงรายละเอียดของสถานที่ (ธุรกิจหรือจุดที่น่าสนใจอื่นๆ) ในตำแหน่งนั้น ดูบทแนะนำเกี่ยวกับการแสดง รายละเอียดสถานที่ปัจจุบันบนแผนที่

การทำงานกับข้อมูลตำแหน่ง

ข้อมูลตำแหน่งที่พร้อมใช้งานสำหรับอุปกรณ์ Android รวมถึงตำแหน่งปัจจุบันของอุปกรณ์ ซึ่งระบุโดยใช้เทคโนโลยีหลายอย่างผสมผสานกัน ทิศทางและวิธีการเคลื่อนไหว ตลอดจนว่าอุปกรณ์เคลื่อนที่ข้ามขอบเขตทางภูมิศาสตร์ที่กำหนดไว้ล่วงหน้าหรือเขตพื้นที่เสมือนหรือไม่ คุณสามารถเลือกหลายวิธีในการทำงานกับข้อมูลตำแหน่งได้ ทั้งนี้ขึ้นอยู่กับความต้องการ ของแอปพลิเคชันของคุณ:

• เลเยอร์ตำแหน่งของฉันช่วยให้แสดงตำแหน่งของอุปกรณ์บนแผนที่ได้ง่ายๆ โดยไม่ได้ให้ข้อมูล
• ขอแนะนำให้ใช้ API ตำแหน่งของบริการ Google Play สำหรับคำขอข้อมูลตำแหน่งแบบเป็นโปรแกรมทั้งหมด
• อินเทอร์เฟซ LocationSource ช่วยให้คุณระบุ ผู้ให้บริการตำแหน่งที่กำหนดเองได้

สิทธิ์เข้าถึงตำแหน่ง

หากแอปของคุณจำเป็นต้องเข้าถึงตำแหน่งของผู้ใช้ คุณต้องขอสิทธิ์ด้วยการเพิ่มสิทธิ์เข้าถึงตำแหน่งของ Android ที่เกี่ยวข้องลงในแอป

Android ให้สิทธิ์เข้าถึงตำแหน่ง 2 รายการ ได้แก่ ACCESS_COARSE_LOCATION และ ACCESS_FINE_LOCATION สิทธิ์ที่คุณเลือกจะเป็นตัวกำหนดความถูกต้องของตำแหน่งที่ API แสดงผล

• android.permission.ACCESS_COARSE_LOCATION – อนุญาตให้ API แสดงตำแหน่งโดยประมาณของอุปกรณ์ สิทธิ์นี้จะระบุตำแหน่งอุปกรณ์โดยประมาณจากบริการตำแหน่งตามที่อธิบายไว้ในเอกสารประกอบเกี่ยวกับความแม่นยำของตำแหน่งโดยประมาณ
• android.permission.ACCESS_FINE_LOCATION – อนุญาตให้ API ระบุตำแหน่งที่ถูกต้องแม่นยำมากที่สุดจากผู้ให้บริการตำแหน่งที่มีอยู่ ซึ่งรวมถึงระบบดาวเทียมนำร่อง (GPS) และ Wi-Fi และข้อมูลเครือข่ายมือถือ

เพิ่มสิทธิ์ในไฟล์ Manifest ของแอป

หากต้องใช้ตำแหน่งโดยประมาณเท่านั้นเพื่อให้แอปทำงานได้ ให้เพิ่มสิทธิ์ ACCESS_COARSE_LOCATION ลงในไฟล์ Manifest ของแอปโดยทำดังนี้

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp" >
  ...
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
  ...
</manifest>

อย่างไรก็ตาม หากต้องใช้ตำแหน่งที่แน่นอน ให้เพิ่มทั้งสิทธิ์ ACCESS_COARSE_LOCATION และ ACCESS_FINE_LOCATION ลงในไฟล์ Manifest ของแอป ดังนี้

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp" >
  ...
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
  ...
</manifest>

ขอสิทธิ์รันไทม์

Android 6.0 (Marshmallow) เปิดตัวโมเดลใหม่สำหรับการจัดการสิทธิ์ ซึ่งช่วยเพิ่มความคล่องตัวให้กับขั้นตอนสำหรับผู้ใช้เมื่อติดตั้งและอัปเกรดแอป หากแอปกำหนดเป้าหมายเป็น API ระดับ 23 ขึ้นไป คุณสามารถใช้โมเดลสิทธิ์ใหม่ได้

หากแอปของคุณรองรับโมเดลสิทธิ์ใหม่และอุปกรณ์ที่ใช้ Android 6.0 (Marshmallow) ขึ้นไป ผู้ใช้ไม่ต้องให้สิทธิ์ใดๆ เมื่อติดตั้งหรืออัปเกรดแอป โดยแอปต้องตรวจสอบว่ามีสิทธิ์ที่จำเป็นขณะรันไทม์หรือไม่ และขอสิทธิ์หากไม่มีสิทธิ์ ระบบจะแสดงกล่องโต้ตอบที่ขอสิทธิ์จากผู้ใช้

คุณควรขอสิทธิ์ตามบริบทเพื่อให้ผู้ใช้ได้รับประสบการณ์ที่ดีที่สุด หากตำแหน่งมีความสำคัญต่อการทำงานของแอป คุณควรขอสิทธิ์เข้าถึงตำแหน่งเมื่อแอปเริ่มทำงาน วิธีที่ดีคือการใช้หน้าจอต้อนรับที่อบอุ่นหรือวิซาร์ดที่ให้ความรู้ผู้ใช้เกี่ยวกับเหตุผลที่จำเป็นต้องมีสิทธิ์

หากแอปต้องการสิทธิ์ในฟังก์ชันการทำงานเพียงบางส่วน คุณควรขอสิทธิ์เข้าถึงตำแหน่งในขณะที่แอปดำเนินการตามที่จำเป็น

แอปต้องจัดการกรณีที่ผู้ใช้ไม่ได้ ให้สิทธิ์อย่างเหมาะสม เช่น หากต้องใช้สิทธิ์สำหรับฟีเจอร์บางอย่าง แอปก็จะปิดใช้ฟีเจอร์นั้นได้ หากสิทธิ์จำเป็นต่อการทำงานของแอป แอปจะปิดใช้ฟังก์ชันทั้งหมดของแอปและแจ้งให้ผู้ใช้ทราบว่าจำเป็นต้องให้สิทธิ์ดังกล่าว

ตัวอย่างโค้ดต่อไปนี้จะตรวจสอบสิทธิ์ในการใช้ไลบรารี AndroidX ก่อนเปิดใช้เลเยอร์ตำแหน่งของฉัน จากนั้นจะจัดการผลของคำขอสิทธิ์โดยนำ ActivityCompat.OnRequestPermissionsResultCallback จากไลบรารีการสนับสนุนไปใช้ ดังนี้

// Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package com.example.kotlindemos

import android.Manifest
import android.annotation.SuppressLint
import android.content.pm.PackageManager
import android.location.Location
import android.os.Bundle
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import androidx.core.app.ActivityCompat
import androidx.core.app.ActivityCompat.OnRequestPermissionsResultCallback
import androidx.core.content.ContextCompat
import com.example.kotlindemos.PermissionUtils.PermissionDeniedDialog.Companion.newInstance
import com.example.kotlindemos.PermissionUtils.isPermissionGranted
import com.google.android.gms.maps.GoogleMap
import com.google.android.gms.maps.GoogleMap.OnMyLocationButtonClickListener
import com.google.android.gms.maps.GoogleMap.OnMyLocationClickListener
import com.google.android.gms.maps.OnMapReadyCallback
import com.google.android.gms.maps.SupportMapFragment

/**
 * This demo shows how GMS Location can be used to check for changes to the users location.  The
 * "My Location" button uses GMS Location to set the blue dot representing the users location.
 * Permission for [Manifest.permission.ACCESS_FINE_LOCATION] and [Manifest.permission.ACCESS_COARSE_LOCATION]
 * are requested at run time. If either permission is not granted, the Activity is finished with an error message.
 */
class MyLocationDemoActivity : AppCompatActivity(),
    OnMyLocationButtonClickListener,
    OnMyLocationClickListener, OnMapReadyCallback,
    OnRequestPermissionsResultCallback {
    /**
     * Flag indicating whether a requested permission has been denied after returning in
     * [.onRequestPermissionsResult].
     */
    private var permissionDenied = false
    private lateinit var map: GoogleMap
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.my_location_demo)
        val mapFragment =
            supportFragmentManager.findFragmentById(R.id.map) as SupportMapFragment?
        mapFragment?.getMapAsync(this)
    }

    override fun onMapReady(googleMap: GoogleMap) {
        map = googleMap
        googleMap.setOnMyLocationButtonClickListener(this)
        googleMap.setOnMyLocationClickListener(this)
        enableMyLocation()
    }

    /**
     * Enables the My Location layer if the fine location permission has been granted.
     */
    @SuppressLint("MissingPermission")
    private fun enableMyLocation() {

        // 1. Check if permissions are granted, if so, enable the my location layer
        if (ContextCompat.checkSelfPermission(
                this,
                Manifest.permission.ACCESS_FINE_LOCATION
            ) == PackageManager.PERMISSION_GRANTED || ContextCompat.checkSelfPermission(
                this,
                Manifest.permission.ACCESS_COARSE_LOCATION
            ) == PackageManager.PERMISSION_GRANTED
        ) {
            map.isMyLocationEnabled = true
            return
        }

        // 2. If if a permission rationale dialog should be shown
        if (ActivityCompat.shouldShowRequestPermissionRationale(
                this,
                Manifest.permission.ACCESS_FINE_LOCATION
            ) || ActivityCompat.shouldShowRequestPermissionRationale(
                this,
                Manifest.permission.ACCESS_COARSE_LOCATION
            )
        ) {
            PermissionUtils.RationaleDialog.newInstance(
                LOCATION_PERMISSION_REQUEST_CODE, true
            ).show(supportFragmentManager, "dialog")
            return
        }

        // 3. Otherwise, request permission
        ActivityCompat.requestPermissions(
            this,
            arrayOf(
                Manifest.permission.ACCESS_FINE_LOCATION,
                Manifest.permission.ACCESS_COARSE_LOCATION
            ),
            LOCATION_PERMISSION_REQUEST_CODE
        )
    }

    override fun onMyLocationButtonClick(): Boolean {
        Toast.makeText(this, "MyLocation button clicked", Toast.LENGTH_SHORT)
            .show()
        // Return false so that we don't consume the event and the default behavior still occurs
        // (the camera animates to the user's current position).
        return false
    }

    override fun onMyLocationClick(location: Location) {
        Toast.makeText(this, "Current location:\n$location", Toast.LENGTH_LONG)
            .show()
    }

    override fun onRequestPermissionsResult(
        requestCode: Int,
        permissions: Array<String>,
        grantResults: IntArray
    ) {
        if (requestCode != LOCATION_PERMISSION_REQUEST_CODE) {
            super.onRequestPermissionsResult(
                requestCode,
                permissions,
                grantResults
            )
            return
        }

        if (isPermissionGranted(
                permissions,
                grantResults,
                Manifest.permission.ACCESS_FINE_LOCATION
            ) || isPermissionGranted(
                permissions,
                grantResults,
                Manifest.permission.ACCESS_COARSE_LOCATION
            )
        ) {
            // Enable the my location layer if the permission has been granted.
            enableMyLocation()
        } else {
            // Permission was denied. Display an error message
            // Display the missing permission error dialog when the fragments resume.
            permissionDenied = true
        }
    }

    override fun onResumeFragments() {
        super.onResumeFragments()
        if (permissionDenied) {
            // Permission was not granted, display error dialog.
            showMissingPermissionError()
            permissionDenied = false
        }
    }

    /**
     * Displays a dialog with error message explaining that the location permission is missing.
     */
    private fun showMissingPermissionError() {
        newInstance(true).show(supportFragmentManager, "dialog")
    }

    companion object {
        /**
         * Request code for location permission request.
         *
         * @see .onRequestPermissionsResult
         */
        private const val LOCATION_PERMISSION_REQUEST_CODE = 1
    }
}
MyLocationDemoActivity.kt

// Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.


package com.example.mapdemo;

import android.Manifest.permission;
import android.annotation.SuppressLint;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.GoogleMap.OnMyLocationButtonClickListener;
import com.google.android.gms.maps.GoogleMap.OnMyLocationClickListener;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;

import android.Manifest;
import android.content.pm.PackageManager;
import android.location.Location;
import android.os.Bundle;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;
import android.widget.Toast;

/**
 * This demo shows how GMS Location can be used to check for changes to the users location.  The "My
 * Location" button uses GMS Location to set the blue dot representing the users location.
 * Permission for {@link android.Manifest.permission#ACCESS_FINE_LOCATION} and {@link
 * android.Manifest.permission#ACCESS_COARSE_LOCATION} are requested at run time. If either
 * permission is not granted, the Activity is finished with an error message.
 */
public class MyLocationDemoActivity extends AppCompatActivity
    implements
    OnMyLocationButtonClickListener,
    OnMyLocationClickListener,
    OnMapReadyCallback,
    ActivityCompat.OnRequestPermissionsResultCallback {

    /**
     * Request code for location permission request.
     *
     * @see #onRequestPermissionsResult(int, String[], int[])
     */
    private static final int LOCATION_PERMISSION_REQUEST_CODE = 1;

    /**
     * Flag indicating whether a requested permission has been denied after returning in {@link
     * #onRequestPermissionsResult(int, String[], int[])}.
     */
    private boolean permissionDenied = false;

    private GoogleMap map;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.my_location_demo);

        SupportMapFragment mapFragment =
            (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    @Override
    public void onMapReady(@NonNull GoogleMap googleMap) {
        map = googleMap;
        map.setOnMyLocationButtonClickListener(this);
        map.setOnMyLocationClickListener(this);
        enableMyLocation();
    }

    /**
     * Enables the My Location layer if the fine location permission has been granted.
     */
    @SuppressLint("MissingPermission")
    private void enableMyLocation() {
        // 1. Check if permissions are granted, if so, enable the my location layer
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION)
            == PackageManager.PERMISSION_GRANTED
            || ContextCompat.checkSelfPermission(this, permission.ACCESS_COARSE_LOCATION)
            == PackageManager.PERMISSION_GRANTED) {
            map.setMyLocationEnabled(true);
            return;
        }

        // 2. Otherwise, request location permissions from the user.
        PermissionUtils.requestLocationPermissions(this, LOCATION_PERMISSION_REQUEST_CODE, true);
    }

    @Override
    public boolean onMyLocationButtonClick() {
        Toast.makeText(this, "MyLocation button clicked", Toast.LENGTH_SHORT).show();
        // Return false so that we don't consume the event and the default behavior still occurs
        // (the camera animates to the user's current position).
        return false;
    }

    @Override
    public void onMyLocationClick(@NonNull Location location) {
        Toast.makeText(this, "Current location:\n" + location, Toast.LENGTH_LONG).show();
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions,
        @NonNull int[] grantResults) {
        if (requestCode != LOCATION_PERMISSION_REQUEST_CODE) {
            super.onRequestPermissionsResult(requestCode, permissions, grantResults);
            return;
        }

        if (PermissionUtils.isPermissionGranted(permissions, grantResults,
            Manifest.permission.ACCESS_FINE_LOCATION) || PermissionUtils
            .isPermissionGranted(permissions, grantResults,
                Manifest.permission.ACCESS_COARSE_LOCATION)) {
            // Enable the my location layer if the permission has been granted.
            enableMyLocation();
        } else {
            // Permission was denied. Display an error message
            // Display the missing permission error dialog when the fragments resume.
            permissionDenied = true;
        }
    }

    @Override
    protected void onResumeFragments() {
        super.onResumeFragments();
        if (permissionDenied) {
            // Permission was not granted, display error dialog.
            showMissingPermissionError();
            permissionDenied = false;
        }
    }

    /**
     * Displays a dialog with error message explaining that the location permission is missing.
     */
    private void showMissingPermissionError() {
        PermissionUtils.PermissionDeniedDialog
            .newInstance(true).show(getSupportFragmentManager(), "dialog");
    }

}
MyLocationDemoActivity.java

เลเยอร์ตำแหน่งของฉัน

คุณสามารถใช้เลเยอร์ตำแหน่งของฉันและปุ่มตำแหน่งของฉันเพื่อแสดงตำแหน่งปัจจุบันแก่ผู้ใช้บนแผนที่ โทร mMap.setMyLocationEnabled() เพื่อเปิดใช้งานเลเยอร์ตำแหน่งของฉันบนแผนที่

ตัวอย่างต่อไปนี้แสดงการใช้งานแบบง่ายของเลเยอร์ตำแหน่งของฉัน

// Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package com.google.maps.example.kotlin

import android.annotation.SuppressLint
import android.location.Location
import android.os.Bundle
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import com.google.android.gms.maps.GoogleMap
import com.google.android.gms.maps.GoogleMap.OnMyLocationButtonClickListener
import com.google.android.gms.maps.GoogleMap.OnMyLocationClickListener
import com.google.android.gms.maps.OnMapReadyCallback
import com.google.android.gms.maps.SupportMapFragment
import com.google.maps.example.R

internal class MyLocationLayerActivity : AppCompatActivity(),
    OnMyLocationButtonClickListener,
    OnMyLocationClickListener,
    OnMapReadyCallback {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_my_location)
        val mapFragment =
            supportFragmentManager.findFragmentById(R.id.map) as SupportMapFragment
        mapFragment.getMapAsync(this)
    }

    @SuppressLint("MissingPermission")
    override fun onMapReady(map: GoogleMap) {
        // TODO: Before enabling the My Location layer, you must request
        // location permission from the user. This sample does not include
        // a request for location permission.
        map.isMyLocationEnabled = true
        map.setOnMyLocationButtonClickListener(this)
        map.setOnMyLocationClickListener(this)
    }

    override fun onMyLocationClick(location: Location) {
        Toast.makeText(this, "Current location:\n$location", Toast.LENGTH_LONG)
            .show()
    }

    override fun onMyLocationButtonClick(): Boolean {
        Toast.makeText(this, "MyLocation button clicked", Toast.LENGTH_SHORT)
            .show()
        // Return false so that we don't consume the event and the default behavior still occurs
        // (the camera animates to the user's current position).
        return false
    }
}
MyLocationLayerActivity.kt

      

// Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package com.google.maps.example;

import android.annotation.SuppressLint;
import android.location.Location;
import android.os.Bundle;
import android.widget.Toast;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;

import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;

class MyLocationLayerActivity extends AppCompatActivity
    implements GoogleMap.OnMyLocationButtonClickListener,
    GoogleMap.OnMyLocationClickListener,
    OnMapReadyCallback {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_my_location);

        SupportMapFragment mapFragment =
            (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    @SuppressLint("MissingPermission")
    @Override
    public void onMapReady(GoogleMap map) {
        // TODO: Before enabling the My Location layer, you must request
        // location permission from the user. This sample does not include
        // a request for location permission.
        map.setMyLocationEnabled(true);
        map.setOnMyLocationButtonClickListener(this);
        map.setOnMyLocationClickListener(this);
    }

    @Override
    public void onMyLocationClick(@NonNull Location location) {
        Toast.makeText(this, "Current location:\n" + location, Toast.LENGTH_LONG)
            .show();
    }

    @Override
    public boolean onMyLocationButtonClick() {
        Toast.makeText(this, "MyLocation button clicked", Toast.LENGTH_SHORT)
            .show();
        // Return false so that we don't consume the event and the default behavior still occurs
        // (the camera animates to the user's current position).
        return false;
    }
}
MyLocationLayerActivity.java

      

เมื่อเปิดใช้งานเลเยอร์ตำแหน่งของฉัน ปุ่มตำแหน่งของฉันจะปรากฏขึ้นที่มุมขวาบนของแผนที่ เมื่อผู้ใช้คลิกปุ่ม กล้องจะตั้งศูนย์กลางของแผนที่ไว้ที่ตำแหน่งปัจจุบันของอุปกรณ์ หากทราบ ตำแหน่งจะ ระบุบนแผนที่ด้วยจุดสีน้ำเงินเล็กๆ ถ้าอุปกรณ์หยุดอยู่กับที่ หรือเป็นรูปตัววีคว่ำหากอุปกรณ์กำลังเคลื่อนที่

ภาพหน้าจอต่อไปนี้แสดงปุ่มตำแหน่งของฉันที่ด้านขวาบน และจุดสีน้ำเงินของตำแหน่งของฉันที่กึ่งกลางแผนที่

คุณสามารถป้องกันไม่ให้ปุ่ม "ตำแหน่งของฉัน" ปรากฏขึ้นได้ด้วยการโทรไปที่ UiSettings.setMyLocationButtonEnabled(false)

แอปของคุณสามารถตอบสนองต่อเหตุการณ์ต่อไปนี้

• หากผู้ใช้คลิกปุ่ม "ตำแหน่งของฉัน" แอปของคุณจะได้รับการเรียกกลับ onMyLocationButtonClick() จาก GoogleMap.OnMyLocationButtonClickListener
• หากผู้ใช้คลิกจุดสีน้ำเงิน "ตำแหน่งของฉัน" แอปของคุณจะได้รับการเรียกกลับ onMyLocationClick() จาก GoogleMap.OnMyLocationClickListener

API ตำแหน่งของบริการ Google Play

API ตำแหน่งของบริการ Google Play เป็นวิธีที่แนะนำให้ใช้ในการเพิ่มการรับรู้ตำแหน่งลงในแอปพลิเคชัน Android โดยมีฟังก์ชันที่ทำให้คุณสามารถ

• ระบุตำแหน่งของอุปกรณ์
• ฟังการเปลี่ยนแปลงสถานที่
• ระบุรูปแบบการเดินทาง หากอุปกรณ์เคลื่อนที่
• สร้างและตรวจสอบพื้นที่ทางภูมิศาสตร์ที่กำหนดไว้ล่วงหน้า ซึ่งเรียกว่าเขตพื้นที่เสมือน

API ตำแหน่งช่วยให้คุณสร้างแอปพลิเคชันที่ประหยัดพลังงานและรับรู้ตำแหน่งได้ง่ายๆ API ตำแหน่งมีการเผยแพร่เป็นส่วนหนึ่งของ SDK บริการ Google Play เช่นเดียวกับแผนที่ SDK สำหรับ Android สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ API ตำแหน่ง โปรดดูคลาสการฝึกอบรมของ Android การทำให้แอปรับรู้ตำแหน่งหรือข้อมูลอ้างอิง API ตำแหน่ง ตัวอย่างโค้ดจะรวมไว้เป็นส่วนหนึ่งของ SDK บริการ Google Play