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

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

คุณสามารถรับรหัสสถานที่ได้หลายวิธี โดยใช้เครื่องมือต่อไปนี้

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

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

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

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

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

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

• รหัสสถานที่

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

• รายการช่อง

  เมื่อขอสถานที่ คุณต้องระบุข้อมูลสถานที่ที่จะแสดงผล โดย ส่งรายการค่า Place.Field ที่ระบุข้อมูลที่จะแสดงผล ไม่มีรายการช่องเริ่มต้นที่ แสดงผลในการตอบกลับ

  รายการช่องเป็นแนวทางปฏิบัติแนะนำในการออกแบบเพื่อให้มั่นใจว่าคุณจะไม่ขอ ข้อมูลที่ไม่จำเป็น ซึ่งจะช่วยหลีกเลี่ยงเวลาในการประมวลผลและ การเรียกเก็บเงินที่ไม่จำเป็น รายการนี้มีความสำคัญ เนื่องจากส่งผลต่อค่าใช้จ่ายของแต่ละคำขอ ดูข้อมูลเพิ่มเติมได้ที่ การใช้งาน และการเรียกเก็บเงิน.

  ระบุช่องต่อไปนี้อย่างน้อย 1 ช่อง

  • ช่องต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่แบบ Essentials (เฉพาะรหัส):

    Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME
    

    ดูรายการฟิลด์ข้อมูลทั้งหมดและ SKU ที่เกี่ยวข้องได้ที่ ช่องข้อมูลสถานที่ (ใหม่)

  • ช่องต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่แบบ Essentials:

    Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESS*
        * ใช้แทน Place.Field.ADDRESS (เลิกใช้งานแล้ว)
    Place.Field.LOCATION*
        * ใช้แทน Place.Field.LAT_LNG (เลิกใช้งานแล้ว)
    Place.Field.PLUS_CODE
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.TYPES
Place.Field.VIEWPORT

    ดูรายการฟิลด์ข้อมูลทั้งหมดและ SKU ที่เกี่ยวข้องได้ที่ ช่องข้อมูลสถานที่ (ใหม่)

  • ช่องต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่แบบ Pro:

    Place.Field.ACCESSIBILITY_OPTIONS*
        * ใช้แทน Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (เลิกใช้งานแล้ว)
    Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
        * ใช้แทน Place.Field.NAME ซึ่งเลิกใช้งานแล้ว
    Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
        * ใช้แทน Place.Field.ICON_URL (เลิกใช้งานแล้ว)
    Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
Place.Field.UTC_OFFSET

    ดูรายการฟิลด์ข้อมูลทั้งหมดและ SKU ที่เกี่ยวข้องได้ที่ ช่องข้อมูลสถานที่ (ใหม่)

  • ช่องต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่แบบ Enterprise:

    Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
        * ใช้แทน Place.Field.PHONE_NUMBER ซึ่งเลิกใช้งานแล้ว
    Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT*
        * ใช้แทน Place.Field.USER_RATINGS_TOTAL ซึ่ง เลิกใช้งานแล้ว
    Place.Field.WEBSITE_URI

    ดูรายการฟิลด์ข้อมูลทั้งหมดและ SKU ที่เกี่ยวข้องได้ที่ ช่องข้อมูลสถานที่ (ใหม่)

  • ช่องต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่แบบ Enterprise Plus:

    Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT

    ดูรายการฟิลด์ข้อมูลทั้งหมดและ SKU ที่เกี่ยวข้องได้ที่ ช่องข้อมูลสถานที่ (ใหม่)

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

พารามิเตอร์ที่ไม่บังคับสำหรับ FetchPlaceRequest มีดังนี้

• รหัสภูมิภาค

  รหัสภูมิภาคที่ใช้จัดรูปแบบการตอบกลับ ซึ่งระบุเป็นค่ารหัส CLDR 2 หลัก ไม่มีค่าเริ่มต้น

  หากชื่อประเทศของช่อง Place.Field.FORMATTED_ADDRESS ในการตอบกลับตรงกับ regionCode ระบบจะละเว้นรหัสประเทศจาก Place.Field.FORMATTED_ADDRESS

  รหัส CLDR ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 ยกเว้นบางรายการ เช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ทางเทคนิคแล้วคือสำหรับ หน่วยงาน "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ") พารามิเตอร์นี้อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง

  หากต้องการตั้งค่าพารามิเตอร์รหัสภูมิภาค ให้เรียกใช้เมธอด setRegionCode() เมื่อสร้างออบเจ็กต์ FetchPlaceRequest

• โทเค็นของเซสชัน

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

  หากต้องการตั้งค่าพารามิเตอร์โทเค็นของเซสชัน ให้เรียกใช้เมธอด setSessionToken() เมื่อสร้างออบเจ็กต์ FetchPlaceRequest

ตัวอย่างรายละเอียดสถานที่

ตัวอย่างต่อไปนี้จะขอช่อง ID, DISPLAY_NAME และ FORMATTED_ADDRESS สำหรับ Empire State Building ในนิวยอร์กซิตี้

// 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.DISPLAY_NAME, Place.Field.FORMATTED_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);