텍스트 검색(신규)

플랫폼 선택: Android iOS JavaScript 웹 서비스

텍스트 검색 (신규)은 문자열을 기준으로 장소(예: '뉴욕의 피자') 또는 '신발 가게' 오타와 부근" 또는 '중앙로 123'. 서비스는 장소 목록을 반환합니다. 텍스트 문자열 및 설정된 위치 편중과 일치하는 것을 볼 수 있습니다.

이 서비스는 모호한 주소를 만들 때 특히 유용하며 자동 시스템의 쿼리를 문자열의 주소가 아닌 구성요소는 사업체 뿐만 아니라 있습니다. 모호한 주소 검색어의 예로는 형식이 잘못된 주소가 있습니다. 비즈니스 이름과 같이 주소가 아닌 구성요소가 포함된 요청이 포함됩니다. 요청 과 마찬가지로 위치가 없으면 결과 0개를 반환할 수도 있습니다. 가 설정됩니다.

텍스트 검색 (신규)은 주변 검색과 비슷합니다. (신규). 주요 차이점은 텍스트 검색 (신규)이 를 사용하면 임의의 검색 문자열을 지정할 수 있지만 주변 검색 (신규)은 검색할 수 있습니다.

'서울특별시 강남구 테헤란로 152' 또는 '서울특별시 강남구 테헤란로 152' 영국의 여러 '하이 스트리트' 미국에 있는 여러 '메인 스트리트'가 있습니다. 위치 제한이 없는 한 쿼리는 원하는 결과를 반환하지 않습니다. 있습니다.
"ChainRestaurant New York" 여러 'ChainRestaurant' 뉴욕 지점 상세 주소 또는 도로명도 있습니다.
'10 High Street, Escher UK' 또는 '서울특별시 강남구 테헤란로 152' 'High Street' 1곳만 영국 에셔시에서 근무하고 있습니다. 'Main Street' 1곳만 캘리포니아 플레즌턴에 거주하고 있습니다.
'UniqueRestaurantName New York' 뉴욕에 이 이름을 가진 시설이 하나뿐임 상세 주소 없음 확인할 수 있습니다
"서울의 피자 가게" 이 쿼리에는 위치 제한과 '피자 식당'이 포함되어 있습니다. 은 장소 유형도 있습니다. 여러 결과를 반환합니다.
'+1 514-670-8700'

이 쿼리에는 전화번호가 포함되어 있습니다. 다음에 대한 여러 결과를 반환합니다. 해당 전화번호와 연결된 장소가 표시됩니다.

텍스트 검색 요청

텍스트 검색 요청의 형식은 다음과 같습니다.

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.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.NAME만 포함하도록 필드 목록을 설정합니다. 즉, 응답의 Place 객체는 각 일치 항목을 나타냅니다. 두 필드만 포함합니다.

  • SearchByTextRequest.Builder 사용 kubectl 명령어 SearchByTextRequest 객체를 정의합니다.

    • 텍스트 쿼리 문자열을 'Spicy Vegetarian Food'로 설정합니다.

    • 최대 결과 장소 수를 10으로 설정합니다. 기본값 및 최대 20개입니다.

    • 검색 영역을 위도 및 경도 좌표입니다. 이 지역을 벗어나는 일치 항목은 반환되지 않습니다.

  • OnSuccessListener를 추가하고 다음에서 일치하는 장소를 가져오세요. SearchByTextResponse 객체를 지정합니다.

텍스트 검색 응답

이 SearchByTextResponse 클래스는 검색 요청의 응답을 나타냅니다. SearchByTextResponse 객체에는 다음이 포함됩니다.

  • 일치하는 모든 장소를 나타내는 Place 객체의 목록 일치하는 장소당 Place 객체입니다.

  • 각 Place 객체에는 필드 목록으로 정의된 필드만 포함됩니다. 이 요청에 전달됩니다.

예를 들어 요청에서 필드 목록을 다음과 같이 정의했습니다.

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

이 필드 목록은 응답의 각 Place 객체에 장소 ID와 일치하는 각 장소의 이름. 그런 다음 Place.getId()를 사용하면 됩니다. 및 Place.getName() 메서드를 사용하여 각 Place 객체의 이러한 필드에 액세스합니다.

Place 객체의 데이터에 액세스하는 예를 더 보려면 장소에 액세스하기를 참조하세요. 객체 데이터 필드

필수 매개변수

의 필수 매개변수는 SearchByTextRequest 다음과 같습니다.

  • 필드 목록

    반환할 장소 데이터 필드를 지정합니다. 다음을 전달 Place.Field 값을 반환할 수 있습니다. 광고 항목의 기본 목록이 없습니다. 응답에서 반환된 필드를 반환합니다.

    필드 목록은 불필요한 데이터이므로 불필요한 처리 시간과 있습니다.

    다음 필드 중 하나 이상을 지정합니다.

    • 다음 필드는 Text Search (ID Only) SKU를 트리거합니다.

      Place.Field.ID, Place.Field.NAME

    • 다음 필드는 Text Search (Basic) SKU를 트리거합니다.

      Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ADDRESS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.LAT_LNG, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.UTC_OFFSET, Place.Field.VIEWPORT, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

    • 다음 필드는 Text Search (Advanced) 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

    • 다음 필드는 Text Search (Preferred) 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

    필드 목록 매개변수를 설정하려면 SearchByTextRequest 객체를 빌드할 때 setPlaceFields() 메서드를 호출합니다.

  • 텍스트 쿼리

    검색할 텍스트 문자열(예: '음식점')입니다. '중앙로 123' 또는 '샌프란시스코에서 방문하기 가장 좋은 장소'입니다. API 는 이 문자열을 기준으로 일치 후보를 반환하고 영향을 미칩니다.

    텍스트 쿼리 매개변수를 설정하려면 SearchByTextRequest 객체를 빌드할 때 setTextQuery() 메서드를 호출합니다.

선택적 매개변수

사용 SearchByTextRequest 객체를 사용하여 요청에 대한 선택적 매개변수를 지정합니다.

  • 포함된 유형

    다음에 의해 정의된 지정된 유형과 일치하는 장소로 결과를 제한합니다. 표 A. 하나의 유형만 지정할 수 있습니다. 예를 들면 다음과 같습니다.

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

    포함된 유형 매개변수를 설정하려면 SearchByTextRequest 객체를 빌드할 때 setIncludedType() 메서드를 호출합니다.

  • 위치 상세 검색

    검색할 영역을 지정합니다. 이 위치는 편향 역할을 하여 결과를 포함하여 지정된 위치 주변의 결과가 반환될 수 있습니다. 지정된 영역 밖에 있는 것을 볼 수 있습니다.

    위치 제한 또는 위치 편중을 지정할 수 있습니다. 둘 다일 수는 없습니다 위치 제한은 결과가 위치해야 하는 지역이며 결과가 근처에 있어야 하지만 외부에 있을 수 있는 리전 지정 확인할 수 있습니다.

    지역을 직사각형 표시 영역 또는 원형으로 지정합니다.

    • 원은 중심점과 반지름(미터)으로 정의됩니다. 반경 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();

    • 직사각형은 위도-경도 표시 영역으로, 2로 표현됩니다. 대각선으로 낮은 점과 높은 점들을 마주 보고 있습니다. 저점은 남서쪽을 나타냄 높은 지점은 북동쪽을 나타냅니다. 표시됩니다.

      표시 영역은 즉, 해당 경계를 포함합니다. 위도 경계 범위는 -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, 위도 범위가 비어 있습니다.

      낮은 가격과 높은 값을 모두 채워야 하며, 표시된 상자는 비어 있습니다. 표시 영역이 비어 있으면 오류가 발생합니다.

      예를 들어 직사각형 표시 영역의 경우 텍스트 검색 요청.

      위치 상세 검색 매개변수를 설정하려면 SearchByTextRequest 객체를 빌드할 때 setLocationBias() 메서드를 호출합니다.

  • 위치 제한

    검색할 영역을 지정합니다. 지정된 영역을 벗어난 결과는 허용되지 않습니다. 반환합니다. 지역을 직사각형 표시 영역으로 지정합니다. 설명 보기 위치 편향 를 참조하세요.

    위치 제한 또는 위치 편중을 지정할 수 있습니다. 둘 다일 수는 없습니다 위치 제한은 결과가 위치해야 하는 지역이며 결과가 근처에 있어야 하지만 외부에 있을 수 있는 리전 지정 확인할 수 있습니다.

    위치 제한 매개변수를 설정하려면 SearchByTextRequest 객체를 빌드할 때 setLocationRestriction() 메서드를 호출합니다.

  • 최대 결과 수

    반환할 장소 결과의 최대 개수를 지정합니다. 사이여야 합니다. 1부터 20 (기본값)까지 포함됩니다.

    최대 결과 수 매개변수를 설정하려면 SearchByTextRequest 객체를 빌드할 때 setMaxResultCount() 메서드를 호출합니다.

  • 최하 등급

    평균 사용자 평점이 다음 값보다 높은 결과로만 결과를 제한합니다. 또는 이 한도와 같아야 합니다. 값은 0.0 이상, 5.0 이하여야 합니다. 0.5씩 증가합니다 예: 0, 0.5, 1.0, ... , 5.0(포함) 값: 가장 가까운 0.5로 반올림됩니다. 예를 들어 값이 0.6이면 평점이 1.0 미만인 검색 결과일 수도 있습니다

    최소 평점 매개변수를 설정하려면 SearchByTextRequest 객체를 빌드할 때 setMinRating() 메서드를 호출합니다.

  • 지금 영업 중

    true인 경우 영업 중인 장소만 반환합니다. 쿼리가 전송되는 시점입니다. false인 경우 모든 비즈니스를 반환합니다. 공개 상태와 관계없이 Google 지역 정보 데이터베이스에 영업시간을 지정하지 않은 장소는 다음과 같습니다. 이 매개변수를 false로 설정하면 반환됩니다.

    지금 열기 매개변수를 설정하려면 SearchByTextRequest 객체를 빌드할 때 setOpenNow() 메서드를 호출합니다.

  • 가격 수준

    기본적으로 결과에는 모든 가격 수준의 서비스를 제공하는 장소가 포함됩니다. 제한하기 결과를 특정 가격 수준의 장소만 포함하려면 목록을 반환하려는 장소의 가격 수준에 해당하는 정수 값의 개수입니다.

    • 1 - 장소가 저렴한 서비스를 제공합니다.
    • 2 - 합리적인 가격의 서비스를 제공합니다.
    • 3 - 장소가 비싼 서비스를 제공합니다.
    • 4 - 매우 비싼 서비스를 제공합니다.

    가격 수준 매개변수를 설정하려면 SearchByTextRequest 객체를 빌드할 때 setPriceLevels() 메서드를 호출합니다.

  • 순위 환경설정

    다음 유형에 따라 응답에서 결과의 순위가 지정되는 방식을 지정합니다. 검색어:

    • '뉴욕시의 레스토랑'과 같은 범주형 쿼리의 경우 기본 설정은 SearchByTextRequest.RankPreference.RELEVANCE (검색 관련성을 기준으로 검색결과 순위 지정)입니다. 순위 환경설정을 SearchByTextRequest.RankPreference.RELEVANCE 또는 SearchByTextRequest.RankPreference.DISTANCE (거리별로 결과 순위 지정).
    • 'Mountain View, CA'와 같은 비범주형 쿼리의 경우에는 순위 환경설정 매개변수를 설정하지 않은 상태로 두는 것이 좋습니다.

    순위 환경설정 매개변수를 설정하려면 SearchByTextRequest 객체를 빌드할 때 setRankPreference() 메서드를 호출합니다.

  • 지역 코드

    응답 형식을 지정하는 데 사용되는 지역 코드로, <ph type="x-smartling-placeholder"></ph> 2자리 CLDR 코드 값을 제공합니다. 이 매개변수는 편향 효과가 발생할 수도 있습니다. 도움이 될 수 있습니다 기본값은 없습니다.

    응답의 주소 입력란 국가 이름이 국가 코드는 주소에서 생략됩니다.

    대부분의 CLDR 코드는 ISO 3166-1 코드와 동일하지만 몇 가지 주목할 만한 예외가 있습니다 예를 들어 영국의 ccTLD는 "uk" (.co.uk), ISO 3166-1 코드는 'gb'입니다. (기술적으로 '영국 및 북아일랜드'의 법인 소유입니다. 매개변수는 관련 법률에 따라 결과에 영향을 미칠 수 있습니다.

    지역 코드 매개변수를 설정하려면 SearchByTextRequest 객체를 빌드할 때 setRegionCode() 메서드를 호출합니다.

  • 엄격한 유형 필터링

    include 유형 매개변수와 함께 사용됩니다. 설정 시 true, 포함 유형이 반환됩니다. 기본값인 false인 경우 응답에 다음과 같은 장소가 포함될 수 있습니다. 지정된 유형과 일치하지 않습니다.

    엄격한 유형 필터링 매개변수를 설정하려면 SearchByTextRequest 객체를 빌드할 때 setStrictTypeFiltering() 메서드를 호출합니다.