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

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

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

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

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

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

ในการเข้าถึงฟิลด์ข้อมูล ให้เรียกฟิลด์ method ตัวอย่างเช่น หากต้องการเข้าถึงชื่อสถานที่ โปรดโทรไปที่ getName()

พารามิเตอร์ที่จำเป็น

พารามิเตอร์ที่จำเป็นสำหรับ FetchPlaceRequest ได้แก่

พารามิเตอร์ที่ไม่บังคับ

พารามิเตอร์ที่ไม่บังคับสำหรับ 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);