การค้นหาข้อความ (ใหม่)

เลือกแพลตฟอร์ม: Android iOS JavaScript เว็บเซอร์วิส

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

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

นอกเหนือจากพารามิเตอร์ที่จำเป็น, การค้นหาข้อความ (ใหม่) ยังรองรับการปรับแต่งคำค้นหาโดยใช้พารามิเตอร์ ที่ไม่บังคับเพื่อให้ได้ผลลัพธ์ที่ดีขึ้น

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

คำขอการค้นหาข้อความ

คำขอการค้นหาข้อความจะมีรูปแบบดังนี้

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME);

// Define latitude and longitude coordinates of the search area.
LatLng southWest = new LatLng(37.38816277477739, -122.08813770258874);
LatLng northEast = new LatLng(37.39580487866437, -122.07702325966572);

// Use the builder to create a SearchByTextRequest object.
final SearchByTextRequest searchByTextRequest = SearchByTextRequest.builder("Spicy Vegetarian Food", placeFields)
  .setMaxResultCount(10)
  .setLocationRestriction(RectangularBounds.newInstance(southWest, northEast)).build();

// Call PlacesClient.searchByText() to perform the search.
// Define a response handler to process the returned List of Place objects.
placesClient.searchByText(searchByTextRequest)
    .addOnSuccessListener(response -> {
      List<Place> places = response.getPlaces();
    });

ในตัวอย่างนี้ คุณจะทำสิ่งต่อไปนี้

  • ตั้งค่ารายการช่องให้มีเฉพาะ Place.Field.ID และ Place.Field.DISPLAY_NAME ซึ่งหมายความว่าออบเจ็กต์ Place ในการตอบกลับที่แสดงสถานที่ที่ตรงกันแต่ละแห่งจะมีเพียง 2 ช่องนี้

  • ใช้ SearchByTextRequest.Builder เพื่อสร้างออบเจ็กต์ SearchByTextRequest ที่กำหนดการค้นหา

    • ตั้งค่าสตริงข้อความค้นหาเป็น "Spicy Vegetarian Food"

    • ตั้งค่าจำนวนสถานที่ที่แสดงผลลัพธ์สูงสุดเป็น 10 ค่าเริ่มต้นและค่าสูงสุดคือ 20

    • จำกัดพื้นที่ค้นหาเป็นสี่เหลี่ยมผืนผ้าที่กำหนดโดยพิกัดละติจูดและลองจิจูด ระบบจะไม่แสดงผลลัพธ์ที่ตรงกันนอกพื้นที่นี้

  • เพิ่ม OnSuccessListener และรับสถานที่ที่ตรงกันจาก SearchByTextResponse ออบเจ็กต์

การตอบกลับการค้นหาข้อความ

คลาส SearchByTextResponse แสดงการตอบกลับจากคำขอค้นหา ออบเจ็กต์ SearchByTextResponse ประกอบด้วยข้อมูลต่อไปนี้

  • รายการออบเจ็กต์ Place ที่แสดงสถานที่ที่ตรงกันทั้งหมด โดยมีออบเจ็กต์ Place 1 รายการต่อสถานที่ที่ตรงกัน 1 แห่ง

  • ออบเจ็กต์ Place แต่ละรายการจะมีเฉพาะช่องที่กำหนดโดยรายการช่องที่ส่งผ่านในคำขอ

ตัวอย่างเช่น ในคำขอ คุณกำหนดรายการช่องดังนี้

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME);

รายการช่องนี้หมายความว่าออบเจ็กต์ Place แต่ละรายการในการตอบกลับจะมีเฉพาะรหัสสถานที่และชื่อของสถานที่ที่ตรงกันแต่ละแห่ง จากนั้นคุณสามารถใช้เมธอด Place.getId() และ Place.getName() เพื่อเข้าถึงช่องเหล่านี้ในออบเจ็กต์ Place แต่ละรายการ

ดูตัวอย่างเพิ่มเติมเกี่ยวกับการเข้าถึงข้อมูลในออบเจ็กต์ Place ได้ที่หัวข้อเข้าถึงฟิลด์ข้อมูลออบเจ็กต์ Place

การใส่เลขหน้า

คลาส SearchByTextResponse ของการค้นหาข้อความช่วยให้เข้าถึงการใส่เลขหน้าของผลการค้นหาข้อความผ่านเมธอด getPagination() ซึ่งจะแสดงผลออบเจ็กต์ Pagination

ใช้เมธอด hasNextPage() ของออบเจ็กต์ Pagination เพื่อตรวจสอบว่ามีผลการค้นหาหน้าเพิ่มเติมหรือไม่ เมธอดนี้จะแสดงผลค่าบูลีน (จริงหรือเท็จ)

ขณะที่ hasNextPage() แสดงผลเป็นจริง ให้เรียกใช้เมธอด fetchNextPage() เพื่อดึงข้อมูลผลการค้นหาหน้าถัดไป

ตัวอย่างต่อไปนี้แสดงวิธีตรวจสอบว่ามีหน้าถัดไปหรือไม่ แล้วโหลดหน้าดังกล่าว

Kotlin

val searchByTextRequest =
      searchByTextRequest("restaurants", Arrays.asList(Place.Field.NAME)) {
        maxResultCount = 10
      }

// using pagination object (Preferred)
placesClient.searchByText(searchByTextRequest)   
    .addOnSuccessListener {response: SearchByTextResponse ->
        val places = response.places

        val pagination = response.pagination

        if (pagination.hasNextPage()) {
            pagination.setPageSize(20)
            pagination.fetchNextPage()
                    .addOnSuccessListener { nextPageResponse ->
                          val nextPagePlaces = nextPageResponse.getPlaces()
                    }
                    .addOnFailureListener {// Handle error with given status code}
        }
}
.addOnFailureListener {
// TODO: Handle error with given status code.
exception -> {
          exception.printStackTrace();
        }
}

Java

SearchByTextRequest searchByTextRequest =
  SearchByTextRequest.builder("restaurants", Arrays.asList(Place.Field.NAME)).setMaxResultCount(10).build();

// using pagination object (Preferred)
placesClient.searchByText(searchByTextRequest)
  .addOnSuccessListener((response) -> {
    List<Place> places = response.getPlaces();
    Log.i(TAG, "Places result: " + places);

    Pagination pagination =
      response.getPagination();

    if (pagination.hasNextPage()) {
      pagination.setPageSize(20); // change the page size from 10 to 20
      pagination.fetchNextPage()
    	  .addOnSuccessListener((nextPageResponse) -> {
            List<Place> nextPagePlaces = nextPageResponse.getPlaces();
            Log.i(TAG, "Next page places result: " + nextPagePlaces);
        });
    }
  })
  .addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
    	// Handle error with given status code
    }
  });

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

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

  • รายการช่อง

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

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

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

    • ช่องต่อไปนี้จะทริกเกอร์ SKU ของการค้นหาข้อความ Essentials (เฉพาะรหัส):

      Place.Field.DISPLAY_NAME*
          * ใช้แทน Place.Field.NAME (เลิกใช้งานแล้วในเวอร์ชัน 4.0)
      Place.Field.ID
      Place.Field.RESOURCE_NAME*
          * มีชื่อทรัพยากรของสถานที่ในรูปแบบ places/PLACE_ID
      ใช้ DISPLAY_NAME เพื่อเข้าถึงชื่อข้อความของสถานที่

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

    • ช่องต่อไปนี้จะทริกเกอร์ SKU ของการค้นหาข้อความ Pro:

      Place.Field.ACCESSIBILITY_OPTIONS*
          ใช้แทน Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (เลิกใช้งานแล้ว)
      Place.Field.ADDRESS_COMPONENTS
      Place.Field.ADR_FORMAT_ADDRESS
      Place.Field.BUSINESS_STATUS
      Place.Field.FORMATTED_ADDRESS*
          ใช้แทน Place.Field.ADDRESS (เลิกใช้งานแล้ว)
      Place.Field.GOOGLE_MAPS_URI
      Place.Field.ICON_BACKGROUND_COLOR
      Place.Field.ICON_MASK_URL *
          ใช้แทน Place.Field.ICON_URL (เลิกใช้งานแล้ว)
      Place.Field.LOCATION*
          ใช้แทน Place.Field.LAT_LNG (เลิกใช้งานแล้ว)
      Place.Field.PHOTO_METADATAS
      Place.Field.PLUS_CODE
      Place.Field.PRIMARY_TYPE
      Place.Field.PRIMARY_TYPE_DISPLAY_NAME
      Place.Field.SHORT_FORMATTED_ADDRESS
      Place.Field.SUB_DESTINATIONS
      Place.Field.TYPES
      Place.Field.UTC_OFFSET
      Place.Field.VIEWPORT

      ดูรายการฟิลด์ทั้งหมดและ 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 ที่เกี่ยวข้องได้ที่หัวข้อ ฟิลด์ข้อมูลสถานที่ (ใหม่)

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

  • ข้อความค้นหา

    สตริงข้อความที่จะค้นหา เช่น "ร้านอาหาร" "123 ถนนเมน" หรือ "สถานที่ที่ดีที่สุดในการไปเที่ยวในซานฟรานซิสโก" API จะแสดงผลการค้นหาที่ตรงกันตามสตริงนี้และจัดลำดับผลการค้นหาตามความเกี่ยวข้องที่ระบบรับรู้

    หากต้องการตั้งค่าพารามิเตอร์ข้อความค้นหา ให้เรียกใช้เมธอด setTextQuery() เมื่อสร้างออบเจ็กต์ SearchByTextRequest

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

ใช้ออบเจ็กต์ SearchByTextRequest เพื่อระบุพารามิเตอร์ที่ไม่บังคับสำหรับคำขอ

  • ประเภทที่รวม

    จำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ที่ตรงกับประเภทที่ระบุซึ่งกำหนดโดย ตาราง ก โดยระบุได้เพียงประเภทเดียว ตัวอย่างเช่น

    • setIncludedType("bar")
    • setIncludedType("pharmacy")

    หากต้องการตั้งค่าพารามิเตอร์ประเภทที่รวม ให้เรียกใช้เมธอด setIncludedType() เมื่อสร้างออบเจ็กต์ SearchByTextRequest

  • การให้น้ำหนักพิเศษกับบางตำแหน่ง

    ระบุพื้นที่ที่จะค้นหา ตำแหน่งนี้จะเป็นตำแหน่งที่ให้น้ำหนักพิเศษ ซึ่งหมายความว่าระบบจะแสดงผลลัพธ์รอบๆ ตำแหน่งที่ระบุ รวมถึงผลลัพธ์ที่อยู่นอกพื้นที่ที่ระบุ

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

    ระบุภูมิภาคเป็นวิวพอร์ตสี่เหลี่ยมผืนผ้าหรือเป็นวงกลม

    • วงกลมจะกำหนดโดยจุดศูนย์กลางและรัศมีเป็นเมตร รัศมี ต้องอยู่ระหว่าง 0.0 ถึง 50000.0 (รวม) ตัวอย่างเช่น

      // Define latitude and longitude coordinates of the center of the search area.
LatLng searchCenter = new LatLng(37.38816277477739, -122.08813770258874);

// Use the builder to create a SearchByTextRequest object.
// Set the radius of the search area to 500.0 meters.
final SearchByTextRequest searchByTextRequest = SearchByTextRequest.builder("Spicy Vegetarian Food", placeFields)
  .setMaxResultCount(10)
  .setLocationBias(CircularBounds.newInstance(searchCenter, 500.0)).build();

    • สี่เหลี่ยมผืนผ้าคือวิวพอร์ตในรูปแบบละติจูด-ลองจิจูด ซึ่งกำหนดด้วยจุดสองจุดที่อยู่มุมตรงข้ามกัน โดยจุดหนึ่งเป็นค่าต่ำสุดและอีกจุดเป็นค่าสูงสุด จุดต่ำสุดจะแสดงมุมตะวันตกเฉียงใต้ ของสี่เหลี่ยมผืนผ้า และจุดสูงสุดจะแสดงมุมตะวันออกเฉียงเหนือ ของสี่เหลี่ยมผืนผ้า

      วิวพอร์ตถือเป็นพื้นที่ปิด ซึ่งหมายรวมถึงขอบเขตของตัววิวพอร์ตเองด้วย ขอบเขตละติจูด ต้องอยู่ระหว่าง -90 ถึง 90 องศา และขอบเขตลองจิจูด ต้องอยู่ระหว่าง -180 ถึง 180 องศา

      • หาก low = high วิวพอร์ตจะประกอบด้วยจุดเดียวดังกล่าว
      • หาก low.longitude > high.longitude หมายความว่าช่วงลองจิจูดกลับด้าน (วิวพอร์ตข้ามเส้นลองจิจูด 180 องศา)
      • หาก low.longitude = -180 องศา และ high.longitude = 180 องศา วิวพอร์ตจะครอบคลุมลองจิจูดทั้งหมด
      • หาก low.longitude = 180 องศา และ high.longitude = -180 องศา ช่วงลองจิจูดจะ ว่างเปล่า
      • หาก low.latitude > high.latitude ช่วงละติจูดจะว่างเปล่า

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

      ดูตัวอย่างวิวพอร์ตสี่เหลี่ยมผืนผ้าได้ที่ คำขอการค้นหาข้อความ

      หากต้องการตั้งค่าพารามิเตอร์การให้น้ำหนักพิเศษกับบางตำแหน่ง ให้เรียกใช้เมธอด setLocationBias() เมื่อสร้างออบเจ็กต์ SearchByTextRequest

  • การจำกัดตำแหน่ง

    ระบุพื้นที่ที่จะค้นหา ระบบจะไม่แสดงผลลัพธ์นอกพื้นที่ที่ระบุ ระบุภูมิภาคเป็นวิวพอร์ตสี่เหลี่ยมผืนผ้า ดูคำอธิบาย ของ การให้น้ำหนักพิเศษกับบางตำแหน่ง เพื่อดูข้อมูลเกี่ยวกับการกำหนดวิวพอร์ต

    คุณสามารถระบุการจำกัดตำแหน่งหรือการให้น้ำหนักพิเศษกับบางตำแหน่ง แต่จะระบุทั้ง 2 อย่างไม่ได้ การจำกัดตำแหน่งคือการระบุภูมิภาคที่ผลการค้นหาต้องอยู่ในนั้น ส่วนการให้น้ำหนักพิเศษกับบางตำแหน่งคือการระบุภูมิภาคที่ผลการค้นหาต้องอยู่ใกล้เคียง แต่สามารถอยู่นอกพื้นที่ได้

    หากต้องการตั้งค่าพารามิเตอร์การจำกัดตำแหน่ง ให้เรียกใช้เมธอด setLocationRestriction() เมื่อสร้างออบเจ็กต์ SearchByTextRequest

  • จำนวนผลลัพธ์สูงสุด

    ระบุจำนวนผลการค้นหาสถานที่สูงสุดที่จะแสดงผล ต้องอยู่ระหว่าง 1 ถึง 20 (ค่าเริ่มต้น) เท่านั้น

    หากต้องการตั้งค่าพารามิเตอร์จำนวนผลลัพธ์สูงสุด ให้เรียกใช้เมธอด setMaxResultCount() เมื่อสร้างออบเจ็กต์ SearchByTextRequest

  • คะแนนขั้นต่ำ

    จำกัดผลการค้นหาให้แสดงเฉพาะผลการค้นหาที่มีการให้คะแนนของผู้ใช้เฉลี่ยมากกว่า หรือเท่ากับขีดจำกัดนี้ ค่าต้องอยู่ระหว่าง 0.0 ถึง 5.0 (รวม) โดยเพิ่มขึ้นทีละ 0.5 เช่น 0, 0.5, 1.0, ... , 5.0 (รวม) ระบบจะปัดเศษค่าขึ้นเป็น 0.5 ที่ใกล้เคียงที่สุด เช่น ค่า 0.6 จะตัดผลการค้นหาทั้งหมด ที่มีคะแนนน้อยกว่า 1.0 ออก

    หากต้องการตั้งค่าพารามิเตอร์คะแนนขั้นต่ำ ให้เรียกใช้เมธอด setMinRating() เมื่อสร้างออบเจ็กต์ SearchByTextRequest

  • เปิดอยู่

    หากตั้งค่าเป็น true ระบบจะแสดงเฉพาะสถานที่ที่เปิดให้บริการ ในขณะที่ส่งคำค้นหา หากตั้งค่าเป็น false ระบบจะแสดงธุรกิจทั้งหมด ไม่ว่าสถานะจะเป็นเปิดหรือปิด ระบบจะแสดงสถานที่ที่ไม่ได้ระบุเวลาทำการในฐานข้อมูล Google Places หากคุณตั้งค่าพารามิเตอร์นี้เป็น false

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

  • ระดับราคา

    โดยค่าเริ่มต้น ผลการค้นหาจะรวมสถานที่ที่ให้บริการในทุกระดับราคา หากต้องการจำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ในระดับราคาที่เฉพาะเจาะจง คุณสามารถส่งรายการค่าจำนวนเต็มที่สอดคล้องกับระดับราคาของสถานที่ที่ต้องการแสดงผลได้ ดังนี้

    • 1 - สถานที่ให้บริการราคาไม่แพง
    • 2 - สถานที่ให้บริการราคาสมเหตุสมผล
    • 3 - สถานที่ให้บริการราคาสูง
    • 4 - สถานที่ให้บริการราคาสูงมาก

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

  • ค่ากำหนดอันดับ

    ระบุวิธีจัดอันดับผลการค้นหาในการตอบกลับตามประเภทของ คำค้นหา ดังนี้

    • สำหรับคำค้นหาตามหมวดหมู่ เช่น "ร้านอาหารในนิวยอร์ก" ค่าเริ่มต้นคือ SearchByTextRequest.RankPreference.RELEVANCE (จัดอันดับผลการค้นหาตามความเกี่ยวข้อง) คุณสามารถตั้งค่ากำหนดอันดับเป็น SearchByTextRequest.RankPreference.RELEVANCE หรือ SearchByTextRequest.RankPreference.DISTANCE (จัดอันดับผลการค้นหาตามระยะทาง)
    • สำหรับคำค้นหาที่ไม่ใช่ตามหมวดหมู่ เช่น "Mountain View, CA" เราขอแนะนำ ให้คุณปล่อยพารามิเตอร์ค่ากำหนดอันดับไว้โดยไม่ตั้งค่า

    หากต้องการตั้งค่าพารามิเตอร์ค่ากำหนดอันดับ ให้เรียกใช้เมธอด setRankPreference() เมื่อสร้างออบเจ็กต์ SearchByTextRequest

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

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

    หากชื่อประเทศของช่องที่อยู่ในการตอบกลับตรงกับ รหัสภูมิภาค ระบบจะละเว้นรหัสประเทศจากที่อยู่

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

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

  • การกรองประเภทแบบเข้มงวด

    ใช้กับพารามิเตอร์ประเภทที่รวม เมื่อตั้งค่าเป็น true ระบบจะแสดงเฉพาะสถานที่ที่ตรงกับประเภทที่ระบุโดย ประเภทที่รวม เมื่อตั้งค่าเป็น false ซึ่งเป็นค่าเริ่มต้น การตอบกลับอาจมีสถานที่ที่ไม่ตรงกับประเภทที่ระบุ

    หากต้องการตั้งค่าพารามิเตอร์การกรองประเภทแบบเข้มงวด ให้เรียกใช้เมธอด setStrictTypeFiltering() เมื่อสร้างออบเจ็กต์ SearchByTextRequest