คุณขอรายละเอียดเพิ่มเติมเกี่ยวกับสถานประกอบการหรือจุดสนใจหนึ่งๆ ได้โดยใช้รหัสสถานที่และสร้างคำขอรายละเอียดสถานที่ (ใหม่) รายละเอียดสถานที่ (ใหม่) จะแสดงข้อมูลที่ครอบคลุมมากขึ้นเกี่ยวกับสถานที่ที่ระบุ เช่น ที่อยู่ที่สมบูรณ์ หมายเลขโทรศัพท์ การให้คะแนนของผู้ใช้ และรีวิว
การขอรับรหัสสถานที่ทำได้หลายวิธี คุณสามารถใช้สิ่งต่อไปนี้
คำขอรายละเอียดสถานที่ (ใหม่)
คุณขอรายละเอียดสถานที่ได้โดยเรียกใช้ PlacesClient.fetchPlace() แล้วส่งออบเจ็กต์ FetchPlaceRequest ที่มีรหัสสถานที่และรายการช่อง รวมถึงพารามิเตอร์ที่ไม่บังคับ
// Define a place ID.
final String placeId = "INSERT_PLACE_ID_HERE";
// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList("INSERT_PLACE_FIELDS_HERE");
// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);
// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);
คำตอบในรายละเอียดสถานที่ (ใหม่)
รายละเอียดสถานที่ (ใหม่) จะแสดงผลข้อมูลในรูปแบบออบเจ็กต์ Place ซึ่งมีเฉพาะช่องที่คุณขอโดยใช้รายการช่อง ผลลัพธ์ข้อมูลสถานที่ต้องไม่ว่างเปล่า ดังนั้นระบบจะส่งคืนเฉพาะผลลัพธ์สถานที่ที่มีข้อมูล (ตัวอย่างเช่น ถ้าสถานที่ที่ขอไม่มีภาพถ่าย ฟิลด์ภาพถ่ายจะไม่ปรากฏในผลลัพธ์)
หากต้องการเข้าถึงช่องข้อมูล ให้เรียกเมธอดที่เกี่ยวข้อง
เช่น หากต้องการเข้าถึงชื่อสถานที่ ให้โทรหา getName()
พารามิเตอร์ที่จำเป็น
พารามิเตอร์ที่จำเป็นสำหรับ FetchPlaceRequest มีดังนี้
-
รหัสสถานที่
ตัวระบุข้อความที่ระบุสถานที่โดยไม่ซ้ำกัน ซึ่งแสดงผลจากการค้นหาข้อความ (ใหม่) การค้นหาใกล้เคียง (ใหม่) หรือเติมข้อความอัตโนมัติ (ใหม่) ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ภาพรวมรหัสสถานที่
-
รายการช่อง
เมื่อคุณขอสถานที่ คุณต้องระบุข้อมูลสถานที่ที่ต้องการส่งคืน โดยส่งรายการค่า
Place.Fieldที่ระบุข้อมูลที่จะส่งคืน ไม่มีรายการเริ่มต้นของฟิลด์ที่แสดงผลในคำตอบรายการช่องเป็นวิธีการออกแบบที่ดีเพื่อให้มั่นใจว่าคุณจะไม่ขอข้อมูลที่ไม่จำเป็น ซึ่งจะช่วยหลีกเลี่ยงเวลาในการประมวลผลและการเรียกเก็บเงินที่ไม่จำเป็น รายการนี้เป็นปัจจัยสำคัญที่ควรพิจารณาเนื่องจากจะมีผลต่อค่าใช้จ่ายของคำขอแต่ละรายการ ดูข้อมูลเพิ่มเติมได้ที่การใช้งานและการเรียกเก็บเงิน
ระบุช่องต่อไปนี้อย่างน้อย 1 ช่อง
ช่องต่อไปนี้จะเรียก SKU รายละเอียดสถานที่ (รหัสเท่านั้น)
Place.Field.ID,Place.Field.NAME,Place.Field.PHOTO_METADATASช่องต่อไปนี้จะเรียก SKU รายละเอียดสถานที่ (สถานที่ตั้งเท่านั้น)
Place.Field.ADDRESS_COMPONENTS,Place.Field.ADDRESS,Place.Field.LAT_LNG,Place.Field.PLUS_CODE,Place.Field.TYPES,Place.Field.VIEWPORTช่องต่อไปนี้จะเรียก SKU รายละเอียดสถานที่ (พื้นฐาน)
Place.Field.BUSINESS_STATUS,Place.Field.ICON_BACKGROUND_COLOR,Place.Field.ICON_URL,Place.Field.UTC_OFFSET,Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCEช่องต่อไปนี้จะเรียก SKU รายละเอียดสถานที่ (ขั้นสูง) ให้แสดง
Place.Field.CURRENT_OPENING_HOURS,Place.Field.SECONDARY_OPENING_HOURS,Place.Field.PHONE_NUMBER,Place.Field.PRICE_LEVEL,Place.Field.RATING,Place.Field.OPENING_HOURS,Place.Field.USER_RATINGS_TOTAL,Place.Field.WEBSITE_URIช่องต่อไปนี้จะเรียก SKU รายละเอียดสถานที่ (ที่ต้องการ):
Place.Field.CURBSIDE_PICKUP,Place.Field.DELIVERY,Place.Field.DINE_IN,Place.Field.EDITORIAL_SUMMARY,Place.Field.RESERVABLE,Place.Field.REVIEWS,Place.Field.SERVES_BEER,Place.Field.SERVES_BREAKFAST,Place.Field.SERVES_BRUNCH,Place.Field.SERVES_DINNER,Place.Field.SERVES_LUNCH,Place.Field.SERVES_VEGETARIAN_FOOD,Place.Field.SERVES_WINE,Place.Field.TAKEOUT
พารามิเตอร์ที่ไม่บังคับ
พารามิเตอร์ที่ไม่บังคับสำหรับ
FetchPlaceRequestมีดังนี้
รหัสภูมิภาค
รหัสภูมิภาคที่ใช้ในการจัดรูปแบบการตอบกลับ ซึ่งระบุเป็นค่า รหัส CLDR แบบ 2 อักขระ ไม่มีค่าเริ่มต้น
หากชื่อประเทศของช่อง
Place.Field.ADDRESSในการตอบกลับตรงกับregionCodeรหัสประเทศจะไม่แสดงในPlace.Field.ADDRESSรหัส CLDR ส่วนใหญ่เหมือนกับรหัส ISO 3166-1 แต่มีข้อยกเว้นบางประการที่สำคัญ เช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ส่วนรหัส ISO 3166-1 คือ "gb" (ทางเทคนิคสำหรับเอนทิตีของ "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ") พารามิเตอร์นี้อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง
หากต้องการตั้งค่าพารามิเตอร์รหัสภูมิภาค ให้เรียกใช้เมธอด
setRegionCode()เมื่อสร้างออบเจ็กต์FetchPlaceRequest-
โทเค็นของเซสชัน
โทเค็นเซสชันเป็นสตริงที่ผู้ใช้สร้างขึ้นซึ่งติดตาม การเรียกที่เติมข้อความอัตโนมัติ (ใหม่) เป็น "เซสชัน" การเติมข้อความอัตโนมัติ (ใหม่) ใช้โทเค็นเซสชันเพื่อจัดกลุ่มข้อความค้นหาและตำแหน่งที่เลือกของการค้นหาแบบเติมข้อความอัตโนมัติของผู้ใช้เป็นเซสชันที่แยกจากกันเพื่อวัตถุประสงค์ในการเรียกเก็บเงิน ระบบจะส่งโทเค็นเซสชันลงในการเรียกใช้รายละเอียดสถานที่ (ใหม่) ที่ตามมาจากการเรียกการเติมข้อความอัตโนมัติ (ใหม่) ดูข้อมูลเพิ่มเติมได้ที่โทเค็นของเซสชัน
หากต้องการตั้งค่าพารามิเตอร์โทเค็นเซสชัน ให้เรียกใช้เมธอด
setSessionToken()เมื่อสร้างออบเจ็กต์FetchPlaceRequest
ตัวอย่างรายละเอียดสถานที่
ตัวอย่างต่อไปนี้แสดงช่อง ID, NAME และ ADDRESS สำหรับอาคารเอ็มไพร์สเตตในนิวยอร์กซิตี้
// Define a place ID.
final String placeId = "ChIJaXQRs6lZwokRY6EFpJnhNNE";
// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME, Place.Field.ADDRESS);
// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);
// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);