คุณสามารถใช้ Places SDK สำหรับ Android เพื่อค้นหาสถานที่ได้ที่ ตำแหน่งที่รายงานในปัจจุบันของอุปกรณ์ ตัวอย่างสถานที่รวมถึงท้องถิ่น ธุรกิจ จุดที่น่าสนใจ และสถานที่ตั้งทางภูมิศาสตร์
สิทธิ์
คุณไม่จำเป็นต้องประกาศสิทธิ์เพิ่มเติมในไฟล์ Manifest ของแอปเพื่อใช้ไลบรารี
เมื่อไลบรารีประกาศสิทธิ์ทั้งหมดที่ใช้ในไฟล์ Manifest อย่างไรก็ตาม หากแอปใช้
PlacesClient.findCurrentPlace()
คุณต้องขอสิทธิ์เข้าถึงตำแหน่งระหว่างรันไทม์
หากแอปไม่ได้ใช้ PlacesClient.findCurrentPlace()
ให้นำ
เปิดตัวสิทธิ์ ACCESS_FINE_LOCATION
และ ACCESS_COARSE_LOCATION
แล้ว
จากไลบรารีด้วยการเพิ่มค่าต่อไปนี้ในไฟล์ Manifest
<manifest ... xmlns:tools="http://schemas.android.com/tools"> ... <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" tools:node="remove"/> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" tools:node="remove"/> ... </manifest>
อ่านเพิ่มเติมเกี่ยวกับ สิทธิ์และพิจารณาใช้ EasyPermissions เพื่อเริ่มต้นใช้งาน
รับข้อมูลตำแหน่งปัจจุบัน
เพื่อค้นหาธุรกิจในพื้นที่หรือสถานที่อื่นๆ ที่มีอุปกรณ์อยู่ ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
- โทร
ContextCompat.checkSelfPermission
เพื่อตรวจสอบว่าผู้ใช้ได้ให้สิทธิ์เข้าถึงอุปกรณ์ของตนหรือไม่ ตำแหน่งนั้น แอปของคุณต้องมีโค้ดที่แจ้งให้ผู้ใช้ขอสิทธิ์ด้วย และจัดการกับผลลัพธ์ที่ได้ ดูขอสิทธิ์ของแอป เพื่อดูรายละเอียด - สร้าง
FindCurrentPlaceRequest
, ผ่านList
จากPlace.Field
วินาที โดยระบุ วางประเภทข้อมูลที่แอปของคุณควรขอ - โทร
PlacesClient.findCurrentPlace()
ส่งFindCurrentPlaceRequest
ที่คุณสร้างไว้ก่อนหน้านี้ ครั้งแรก - เรียกดูรายการ
PlaceLikelihood
จากFindCurrentPlaceResponse
ฟิลด์จะสอดคล้องกับผลการค้นหาสถานที่ และแบ่งออกเป็นสามหมวดหมู่การเรียกเก็บเงิน: พื้นฐาน รายชื่อติดต่อ และบรรยากาศ ระบบจะเรียกเก็บเงินช่องพื้นฐานในอัตราฐานและไม่มีค่าใช้จ่ายเพิ่มเติม ระบบจะเรียกเก็บเงินฟิลด์รายชื่อติดต่อและบรรยากาศในอัตราที่สูงกว่า หากต้องการดูข้อมูลเพิ่มเติม เกี่ยวกับวิธีเรียกเก็บเงินสำหรับคำขอให้ดูข้อมูลเกี่ยวกับสถานที่ โปรดดู การใช้งานและการเรียกเก็บเงิน
API จะแสดงผล
FindCurrentPlaceResponse
ใน
Task
FindCurrentPlaceResponse
ประกอบด้วยรายการ
PlaceLikelihood
ออบเจ็กต์ที่แสดงสถานที่ที่อุปกรณ์น่าจะตั้งอยู่ สำหรับ
ในแต่ละสถานที่ ผลลัพธ์จะมี ตัวบ่งชี้ถึงแนวโน้มที่
คือที่ที่ถูกต้อง รายการอาจว่างเปล่าหากไม่มีสถานที่ที่รู้จัก
ตามตำแหน่งที่ระบุของอุปกรณ์
คุณสามารถโทรหา
PlaceLikelihood.getPlace()
เพื่อดึงข้อมูล
Place
และ
PlaceLikelihood.getLikelihood()
เพื่อดูคะแนนแนวโน้มของสถานที่ ค่าที่สูงหมายถึง
ความน่าจะเป็นที่สถานที่ดังกล่าวตรงที่สุด
ตัวอย่างโค้ดต่อไปนี้เรียกดูรายการสถานที่ที่อุปกรณ์อยู่ ที่มีแนวโน้มว่าจะอยู่มากที่สุด และบันทึกชื่อและแนวโน้มของสถานที่แต่ละแห่ง
Kotlin
// Use fields to define the data types to return. val placeFields: List<Place.Field> = listOf(Place.Field.NAME) // Use the builder to create a FindCurrentPlaceRequest. val request: FindCurrentPlaceRequest = FindCurrentPlaceRequest.newInstance(placeFields) // Call findCurrentPlace and handle the response (first check that the user has granted permission). if (ContextCompat.checkSelfPermission(this, permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) { val placeResponse = placesClient.findCurrentPlace(request) placeResponse.addOnCompleteListener { task -> if (task.isSuccessful) { val response = task.result for (placeLikelihood: PlaceLikelihood in response?.placeLikelihoods ?: emptyList()) { Log.i( TAG, "Place '${placeLikelihood.place.name}' has likelihood: ${placeLikelihood.likelihood}" ) } } else { val exception = task.exception if (exception is ApiException) { Log.e(TAG, "Place not found: ${exception.statusCode}") } } } } else { // A local method to request required permissions; // See https://developer.android.com/training/permissions/requesting getLocationPermission() }
Java
// Use fields to define the data types to return. List<Place.Field> placeFields = Collections.singletonList(Place.Field.NAME); // Use the builder to create a FindCurrentPlaceRequest. FindCurrentPlaceRequest request = FindCurrentPlaceRequest.newInstance(placeFields); // Call findCurrentPlace and handle the response (first check that the user has granted permission). if (ContextCompat.checkSelfPermission(this, ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) { Task<FindCurrentPlaceResponse> placeResponse = placesClient.findCurrentPlace(request); placeResponse.addOnCompleteListener(task -> { if (task.isSuccessful()){ FindCurrentPlaceResponse response = task.getResult(); for (PlaceLikelihood placeLikelihood : response.getPlaceLikelihoods()) { Log.i(TAG, String.format("Place '%s' has likelihood: %f", placeLikelihood.getPlace().getName(), placeLikelihood.getLikelihood())); } } else { Exception exception = task.getException(); if (exception instanceof ApiException) { ApiException apiException = (ApiException) exception; Log.e(TAG, "Place not found: " + apiException.getStatusCode()); } } }); } else { // A local method to request required permissions; // See https://developer.android.com/training/permissions/requesting getLocationPermission(); }
หมายเหตุเกี่ยวกับค่าแนวโน้ม
- แนวโน้มจะแสดงความน่าจะเป็นแบบสัมพัทธ์ ของสถานที่ที่ตรงกับมากที่สุดภายในรายการ สถานที่ที่ส่งคืนสำหรับ คำขอเดียว คุณจะเปรียบเทียบแนวโน้มในคำขอต่างๆ ไม่ได้
- ค่าของแนวโน้มจะอยู่ระหว่าง 0.0 ถึง 1.0
ตัวอย่างเช่น เพื่อแสดงความเป็นไปได้ 55% ที่สถานที่ที่ถูกต้องคือสถานที่ A และมีแนวโน้ม 35% ที่จะเป็นสถานที่ B คำตอบมีสมาชิก 2 ราย วาง A ที่มีความน่าจะเป็นของ 0.55 และสถานที่ B โดยมีความน่าจะเป็นที่ 0.35
แสดงการระบุแหล่งที่มาในแอปของคุณ
เมื่อแอปแสดงข้อมูลที่ได้จาก
PlacesClient.findCurrentPlace()
แอปต้องแสดงการระบุแหล่งที่มาด้วย ดูเอกสารใน
การระบุแหล่งที่มา