รายละเอียดสถานที่ (ใหม่)

เลือกแพลตฟอร์ม Android iOS JavaScript บริการผ่านเว็บ

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

การรับรหัสสถานที่ทำได้หลายวิธี คุณสามารถใช้

• การค้นหาข้อความ (ใหม่)
• การค้นหาใกล้เคียง (ใหม่)
• เติมข้อความอัตโนมัติ (ใหม่)

หมายเหตุ: รายละเอียดสถานที่ (ใหม่) มีอยู่ใน Places SDK สำหรับ Android เวอร์ชัน 3.3.0 ขึ้นไป โปรดดูข้อมูลเพิ่มเติมที่หัวข้อเลือก SDK ของคุณ version

คำขอรายละเอียดสถานที่ (ใหม่)

คุณสามารถขอรายละเอียดสถานที่ได้โดยโทรไปที่ 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);

หมายเหตุ: โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการเริ่มต้นใช้งาน PlacesClient ได้ที่ เริ่มต้นไคลเอ็นต์ของ Places API

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

การตอบกลับรายละเอียดสถานที่ (ใหม่)

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

ในการเข้าถึงฟิลด์ข้อมูล ให้เรียกฟิลด์ method ตัวอย่างเช่น หากต้องการเข้าถึงชื่อสถานที่ โปรดโทรไปที่ 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);