Places SDK สําหรับ Android จะให้ข้อมูลอันสมบูรณ์เกี่ยวกับสถานที่แก่แอปของคุณ ซึ่งรวมถึงชื่อและที่อยู่ของสถานที่ สถานที่ตั้งทางภูมิศาสตร์ที่ระบุเป็นพิกัดละติจูด/ลองจิจูด ประเภทสถานที่ (เช่น ไนท์คลับ ร้านค้าสัตว์เลี้ยง พิพิธภัณฑ์) และอื่นๆ หากต้องการเข้าถึงข้อมูลนี้สำหรับสถานที่หนึ่งๆ ให้ใช้รหัสสถานที่ ซึ่งเป็นตัวระบุที่คงที่ซึ่งระบุสถานที่หนึ่งๆ ได้อย่างไม่ซ้ำกัน
รายละเอียดสถานที่
ออบเจ็กต์ Place
ให้ข้อมูลเกี่ยวกับสถานที่หนึ่งๆ คุณจับวัตถุ Place
ได้ดังนี้
- โทรไปที่
PlacesClient.fetchPlace()
– ดูคำแนะนำเกี่ยวกับการค้นหาสถานที่ตามรหัส - โทรไปที่
PlacesClient.findCurrentPlace()
– ดูคำแนะนำเกี่ยวกับการระบุตำแหน่งปัจจุบัน
เมื่อขอสถานที่ คุณต้องระบุข้อมูลสถานที่ที่จะแสดง โดยส่งรายการค่า Place.Field ที่ระบุข้อมูลที่จะแสดง รายการนี้เป็นข้อควรพิจารณาที่สำคัญเนื่องจากส่งผลต่อต้นทุนของคำขอแต่ละรายการ
เนื่องจากผลการค้นหาข้อมูลสถานที่ต้องไม่ว่างเปล่า ระบบจึงจะแสดงเฉพาะผลการค้นหาสถานที่ที่มีข้อมูล ตัวอย่างเช่น หากสถานที่ที่ขอไม่มีรูปภาพ photos
ฟิลด์จะไม่ปรากฏในผลการค้นหา
ตัวอย่างต่อไปนี้จะส่งรายการค่า Place.Field 3 รายการเพื่อระบุข้อมูลที่คำขอแสดงผล
Kotlin
// Specify the fields to return. val placeFields = listOf(Place.Field.NAME, Place.Field.RATING, Place.Field.OPENING_HOURS)
Java
// Specify the fields to return. final List<Place.Field> placeFields = Arrays.asList(Place.Field.NAME, Place.Field.RATING, Place.Field.OPENING_HOURS);
เข้าถึงช่องข้อมูลออบเจ็กต์สถานที่
หลังจากได้รับออบเจ็กต์ Place
แล้ว ให้ใช้เมธอดของออบเจ็กต์เพื่อเข้าถึงช่องข้อมูลซึ่งระบุไว้ในคำขอ หากไม่มีฟิลด์นี้ในออบเจ็กต์ Place
เมธอดที่เกี่ยวข้องจะแสดงผลเป็นค่าว่าง ด้านล่างนี้คือตัวอย่างวิธีการที่ใช้ได้บางส่วน
getAddress()
– ที่อยู่ของสถานที่ในรูปแบบที่มนุษย์อ่านได้getAddressComponents()
–List
คอมโพเนนต์ที่อยู่ของสถานที่นี้ คอมโพเนนต์เหล่านี้มีไว้เพื่อดึงข้อมูลที่มีโครงสร้างเกี่ยวกับที่อยู่ของสถานที่ เช่น ค้นหาเมืองที่สถานที่ตั้งอยู่ อย่าใช้คอมโพเนนต์เหล่านี้สำหรับการจัดรูปแบบที่อยู่ ให้เรียกใช้getAddress()
แทน ซึ่งจะแสดงที่อยู่ที่มีการจัดรูปแบบเป็นภาษาท้องถิ่นgetId()
– ตัวระบุแบบข้อความของสถานที่ อ่านข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ในส่วนที่เหลือของหน้านี้getLatLng()
– สถานที่ตั้งทางภูมิศาสตร์ของสถานที่ ซึ่งระบุเป็นพิกัดละติจูดและลองจิจูดgetName()
– ชื่อสถานที่getOpeningHours()
–OpeningHours
ของสถานที่ เรียกใช้OpeningHours.getWeekdayText()
เพื่อแสดงรายการสตริงที่แสดงเวลาเปิดและปิดของแต่ละวันในสัปดาห์ เรียกใช้OpeningHours.getPeriods()
เพื่อแสดงรายการออบเจ็กต์period
พร้อมข้อมูลโดยละเอียดเพิ่มเติมซึ่งเทียบเท่ากับข้อมูลที่getWeekdayText()
ระบุออบเจ็กต์
Place
ยังมีเมธอดgetCurrentOpeningHours()
ที่แสดงเวลาทําการของสถานที่ในช่วง 7 วันข้างหน้า และgetSecondaryOpeningHours()
ที่แสดงเวลาทําการรองของสถานที่ในช่วง 7 วันข้างหน้าisOpen()
– บูลีนที่ระบุว่าสถานที่เปิดอยู่หรือไม่ หากไม่ได้ระบุเวลา ค่าเริ่มต้นจะเป็น "ตอนนี้"isOpen
จะแสดงก็ต่อเมื่อทั้งPlace.Field.UTC_OFFSET
และPlace.Field.OPENING_HOURS
พร้อมใช้งาน โปรดระบุช่องPlace.Field.BUSINESS_STATUS
และPlace.Field.UTC_OFFSET
ในคำขอสถานที่เดิมเพื่อให้ได้ผลลัพธ์ที่ถูกต้อง หากไม่ได้ขอ ระบบจะถือว่าธุรกิจดำเนินงานอยู่ ดูวิธีใช้isOpen
กับรายละเอียดสถานที่ได้จากวิดีโอนี้
ตัวอย่างมีดังต่อไปนี้
Kotlin
val name = place.name val address = place.address val location = place.latLng
Java
final CharSequence name = place.getName(); final CharSequence address = place.getAddress(); final LatLng location = place.getLatLng();
รับสถานที่ตามรหัส
รหัสสถานที่คือตัวระบุที่เป็นข้อความซึ่งระบุสถานที่หนึ่งๆ โดยไม่ซ้ำกัน ใน Place.getId()
ของ Places SDK สําหรับ Android คุณสามารถเรียกข้อมูลรหัสของสถานที่ได้
บริการการเติมข้อความอัตโนมัติของสถานที่จะแสดงรหัสสถานที่สำหรับสถานที่แต่ละแห่งที่ตรงกับข้อความค้นหาและตัวกรองที่ระบุ คุณสามารถจัดเก็บรหัสสถานที่และใช้รหัสดังกล่าวเพื่อเรียกข้อมูลออบเจ็กต์ Place
อีกครั้งในภายหลัง
หากต้องการรับสถานที่ตามรหัส ให้เรียกใช้ PlacesClient.fetchPlace()
โดยส่ง FetchPlaceRequest
API จะแสดงผล FetchPlaceResponse
ใน Task
FetchPlaceResponse
มีออบเจ็กต์ Place
ที่ตรงกับรหัสสถานที่ที่ระบุ
ตัวอย่างโค้ดต่อไปนี้แสดงการเรียกใช้ fetchPlace()
เพื่อรับรายละเอียดของสถานที่ที่ระบุ
Kotlin
// Define a Place ID. val placeId = "INSERT_PLACE_ID_HERE" // Specify the fields to return. val placeFields = listOf(Place.Field.ID, Place.Field.NAME) // Construct a request object, passing the place ID and fields array. val request = FetchPlaceRequest.newInstance(placeId, placeFields) placesClient.fetchPlace(request) .addOnSuccessListener { response: FetchPlaceResponse -> val place = response.place Log.i(PlaceDetailsActivity.TAG, "Place found: ${place.name}") }.addOnFailureListener { exception: Exception -> if (exception is ApiException) { Log.e(TAG, "Place not found: ${exception.message}") val statusCode = exception.statusCode TODO("Handle error with given status code") } }
Java
// Define a Place ID. final String placeId = "INSERT_PLACE_ID_HERE"; // Specify the fields to return. final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME); // Construct a request object, passing the place ID and fields array. final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields); placesClient.fetchPlace(request).addOnSuccessListener((response) -> { Place place = response.getPlace(); Log.i(TAG, "Place found: " + place.getName()); }).addOnFailureListener((exception) -> { if (exception instanceof ApiException) { final ApiException apiException = (ApiException) exception; Log.e(TAG, "Place not found: " + exception.getMessage()); final int statusCode = apiException.getStatusCode(); // TODO: Handle error with given status code. } });
รับสถานะเปิด
เมธอด PlacesClient.isOpen(IsOpenRequest request)
จะแสดงผลออบเจ็กต์ IsOpenResponse
ซึ่งระบุว่าสถานที่เปิดอยู่หรือไม่ ณ เวลาที่มีการเรียกใช้
เมธอดนี้ใช้อาร์กิวเมนต์ประเภท IsOpenRequest
รายการเดียวที่มีข้อมูลต่อไปนี้
- ออบเจ็กต์
Place
หรือสตริงที่ระบุรหัสสถานที่ - ค่าเวลาที่ไม่บังคับซึ่งระบุเวลาเป็นมิลลิวินาทีนับจาก 1970-01-01T00:00:00Z หากไม่ได้ระบุเวลา ค่าเริ่มต้นจะเป็น "ตอนนี้"
วิธีนี้กำหนดให้ฟิลด์ต่อไปนี้ต้องอยู่ในออบเจ็กต์ Place
Place.Field.BUSINESS_STATUS
Place.Field.CURRENT_OPENING_HOURS
Place.Field.OPENING_HOURS
Place.Field.UTC_OFFSET
หากไม่ได้ระบุฟิลด์เหล่านี้ในออบเจ็กต์ Place
หรือหากคุณส่งรหัสสถานที่ ระบบจะใช้เมธอดนี้เพื่อดึงข้อมูลPlacesClient.fetchPlace()
ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างออบเจ็กต์สถานที่ซึ่งมีช่องที่จำเป็นได้ที่รายละเอียดสถานที่
ตัวอย่างต่อไปนี้จะระบุว่าสถานที่เปิดอยู่หรือไม่ ในตัวอย่างนี้ คุณจะส่งเฉพาะรหัสสถานที่ไปยัง isOpen()
เท่านั้น
Kotlin
val isOpenCalendar: Calendar = Calendar.getInstance() val placeId = "ChIJD3uTd9hx5kcR1IQvGfr8dbk" val request: IsOpenRequest = try { IsOpenRequest.newInstance(placeId, isOpenCalendar.timeInMillis) } catch (e: IllegalArgumentException) { e.printStackTrace() return } val isOpenTask: Task<IsOpenResponse> = placesClient.isOpen(request) isOpenTask.addOnSuccessListener { response -> val isOpen = response.isOpen } // ...
Java
@NonNull Calendar isOpenCalendar = Calendar.getInstance(); String placeId = "ChIJD3uTd9hx5kcR1IQvGfr8dbk"; IsOpenRequest isOpenRequest; try { isOpenRequest = IsOpenRequest.newInstance(placeId, isOpenCalendar.getTimeInMillis()); } catch (IllegalArgumentException e) { e.printStackTrace(); return; } Task<IsOpenResponse> placeTask = placesClient.isOpen(isOpenRequest); placeTask.addOnSuccessListener( (response) -> isOpen = response.isOpen()); // ...
ตัวอย่างถัดไปแสดงการเรียกใช้ isOpen()
ที่คุณส่งออบเจ็กต์ Place
ออบเจ็กต์ Place
ต้องมีรหัสสถานที่ที่ถูกต้อง
Kotlin
val isOpenCalendar: Calendar = Calendar.getInstance() var place: Place val placeId = "ChIJD3uTd9hx5kcR1IQvGfr8dbk" // Specify the required fields for an isOpen request. val placeFields: List<Place.Field> = listOf( Place.Field.BUSINESS_STATUS, Place.Field.CURRENT_OPENING_HOURS, Place.Field.ID, Place.Field.OPENING_HOURS, Place.Field.UTC_OFFSET ) val placeRequest: FetchPlaceRequest = FetchPlaceRequest.newInstance(placeId, placeFields) val placeTask: Task<FetchPlaceResponse> = placesClient.fetchPlace(placeRequest) placeTask.addOnSuccessListener { placeResponse -> place = placeResponse.place val isOpenRequest: IsOpenRequest = try { IsOpenRequest.newInstance(place, isOpenCalendar.timeInMillis) } catch (e: IllegalArgumentException) { e.printStackTrace() return@addOnSuccessListener } val isOpenTask: Task<IsOpenResponse> = placesClient.isOpen(isOpenRequest) isOpenTask.addOnSuccessListener { isOpenResponse -> val isOpen = isOpenResponse.isOpen } // ... } // ...
Java
@NonNull Calendar isOpenCalendar = Calendar.getInstance(); String placeId = "ChIJD3uTd9hx5kcR1IQvGfr8dbk"; // Specify the required fields for an isOpen request. List<Place.Field> placeFields = new ArrayList<>(Arrays.asList( Place.Field.BUSINESS_STATUS, Place.Field.CURRENT_OPENING_HOURS, Place.Field.ID, Place.Field.OPENING_HOURS, Place.Field.UTC_OFFSET )); FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields); Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request); placeTask.addOnSuccessListener( (placeResponse) -> { Place place = placeResponse.getPlace(); IsOpenRequest isOpenRequest; try { isOpenRequest = IsOpenRequest.newInstance(place, isOpenCalendar.getTimeInMillis()); } catch (IllegalArgumentException e) { e.printStackTrace(); return; } Task<IsOpenResponse> isOpenTask = placesClient.isOpen(isOpenRequest); isOpenTask.addOnSuccessListener( (isOpenResponse) -> isOpen = isOpenResponse.isOpen()); // ... }); // ...
แสดงการระบุแหล่งที่มาในแอป
เมื่อแอปแสดงข้อมูลสถานที่ รวมถึงรีวิวสถานที่ แอปจะต้องแสดงการระบุแหล่งที่มาด้วย ดูข้อมูลเพิ่มเติมได้ที่การระบุแหล่งที่มา
ข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่
รหัสสถานที่ที่ใช้ใน Places SDK สําหรับ Android เป็นตัวระบุเดียวกับที่ใช้ใน Places API รหัสสถานที่แต่ละรหัสจะอ้างอิงถึงสถานที่ได้เพียงแห่งเดียว แต่สถานที่แห่งเดียวอาจมีรหัสสถานที่ได้มากกว่า 1 รหัส นอกจากนี้ยังมีสถานการณ์อื่นๆ ที่อาจทําให้สถานที่ได้รับรหัสสถานที่ใหม่ ตัวอย่างเช่น กรณีนี้อาจเกิดขึ้นหากธุรกิจย้ายไปสถานที่ใหม่
เมื่อขอสถานที่โดยระบุรหัสสถานที่ คุณจะมั่นใจได้ว่าจะได้รับสถานที่เดียวกันในการตอบกลับเสมอ (หากสถานที่ดังกล่าวยังคงมีอยู่) อย่างไรก็ตาม โปรดทราบว่าคำตอบอาจมีรหัสสถานที่ซึ่งแตกต่างจากรหัสในคำขอ
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมรหัสสถานที่