주변 검색 (신규)

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

주변 지역 검색 (신규) 요청은 지역을 입력으로 취합니다. 위도와 경도로 정의되는 원으로 지정해서 검색합니다. 원의 중심점의 좌표와 반경(미터)입니다. 이 요청은 일치하는 장소의 목록을 반환하며, 각 목록은 Place 드림 객체에 대한 검색 결과를 반환할 수 있습니다.

기본적으로 응답에는 검색 영역 내에 모든 유형의 장소가 포함됩니다. 원하는 경우 장소 유형 목록을 지정하여 응답을 필터링할 수 있습니다. 명시적으로 포함하거나 제외할 수 있습니다. 예를 들어 를 사용하여 응답에 '음식점' 유형의 장소만 포함합니다. 'bakery', 'cafe'를 입력하거나 '학교' 유형의 모든 장소를 제외하세요.

주변 검색 (신규) 요청

다음을 호출하여 주변 지역 검색 (신규) 요청 PlacesClient.searchNearby님, 전달 SearchNearbyRequest 객체를 정의합니다.

SearchNearbyRequest 객체는 필수 및 선택 항목을 모두 매개변수를 제공합니다. 필수 매개변수는 다음과 같습니다.

  • Place 객체에서 반환할 필드의 목록으로, 필드 마스크 필드 목록에 필드를 하나 이상 지정하지 않거나 필드 목록을 생략하면 호출이 오류를 반환합니다.
  • 검색 영역에 대한 위치 제한으로, 위도/경도 쌍과 반경 값(미터)입니다.

이 근처 검색 요청 예시는 응답 Place 객체가 각 장소의 장소 필드 Place.Field.ID와 Place.Field.NAME가 포함되어 있습니다. Place 객체를 반환합니다. 또한 응답을 필터링하여 '음식점' 유형의 장소 반환 및 '카페'를 제외하되, 유형의 장소는 제외합니다. "피자 식당" 'american_Restaurant'이 있습니다.

// Define a list of fields to include in the response for each returned place.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

// Define the search area as a 1000 meter diameter circle in New York, NY.
LatLng center = new LatLng(40.7580, -73.9855);
CircularBounds circle = CircularBounds.newInstance(center, /* radius = */ 1000);

// Define a list of types to include.
final List<String> includedTypes = Arrays.asList("restaurant", "cafe");
// Define a list of types to exclude.
final List<String> excludedTypes = Arrays.asList("pizza_restaurant", "american_restaurant");

// Use the builder to create a SearchNearbyRequest object.
final SearchNearbyRequest searchNearbyRequest =
SearchNearbyRequest.builder(/* location restriction = */ circle, placeFields)
    .setIncludedTypes(includedTypes)
    .setExcludedTypes(excludedTypes)
    .setMaxResultCount(10)
    .build());

// Call placesClient.searchNearby() to perform the search.
// Define a response handler to process the returned List of Place objects.
placesClient.searchNearby(searchNearbyRequest)
    .addOnSuccessListener(response -> {
      List<Place> places = response.getPlaces();
    });
<ph type="x-smartling-placeholder">

주변 지역 검색 (신규) 응답

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

  • 일치하는 모든 장소를 나타내는 Place 객체의 목록 일치하는 장소당 Place 객체입니다.
  • 각 Place 객체에는 필드 목록으로 정의된 필드만 포함됩니다. 이 요청에 전달됩니다.

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

// Define a list of fields to include in the response for each returned place.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

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

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

필수 매개변수

사용 SearchNearbyRequest 드림 객체를 사용하여 검색에 필요한 매개변수를 지정합니다.

  • 필드 목록

    장소 세부정보를 요청할 때는 반환할 데이터를 장소의 Place 객체(필드 마스크)입니다. 필드 마스크를 정의하려면 값의 배열을 Place.Field 드림 SearchNearbyRequest 객체에 추가합니다. 필드 마스킹은 불필요한 데이터를 요청하지 않도록 해야 합니다. 이렇게 하면 불필요한 처리 시간과 비용을 과도하게 줄일 수 있습니다

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

    • 다음 필드가 주변 검색을 실행합니다. (기본) 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.ID, Place.Field.NAME, Place.Field.TYPES, Place.Field.UTC_OFFSET, Place.Field.VIEWPORT, 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

    필드 목록 매개변수를 설정하려면 setPlaceFields() 드림 SearchNearbyRequest 객체를 빌드할 때 이 메서드를 사용합니다.

    다음 예는 두 개의 필드 값 목록을 정의하여 요청에서 반환된 Place 객체에는 Place.Field.ID 및 Place.Field.NAME 필드:

// Define a list of fields to include in the response for each returned place.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

  • 위치 제한

    가 LocationRestriction 드림 검색할 지역을 정의하는 객체로, 원으로 지정되며 중심점과 반경(미터)입니다. 반경은 다음보다 커야 합니다. 0.0 이하 50000.0으로 설정합니다. 너무 작은 반경을 지정하면 응답으로 ZERO_RESULTS를 반환합니다.

    위치 제한 매개변수를 설정하려면 setLocationRestriction() 드림 SearchNearbyRequest 객체를 빌드할 때 이 메서드를 사용합니다.

선택적 매개변수

사용 SearchNearbyRequest 드림 객체를 사용하여 검색에 대한 선택적 매개변수를 지정합니다.

  • 유형 및 기본 유형

    유형에서 유형 목록을 지정할 수 있음 필터링에 사용되는 표 A 있습니다. 각 유형 제한 카테고리에 최대 50개의 유형을 지정할 수 있습니다.

    한 장소에는 유형에서 단일 기본 유형만 있을 수 있습니다. 다음과 관련된 표 A 있습니다. 예를 들어 기본 유형은 "mexican_restaurant" 또는 "steak_house" 사용 결과를 필터링할 includedPrimaryTypes 및 excludedPrimaryTypes 장소의 기본 유형입니다.

    또한 장소에는 유형의 여러 유형 값이 있을 수 있습니다. 표 A 관련이 있습니다. 예를 들어 레스토랑의 유형은 다음과 같습니다. "seafood_restaurant", "restaurant", "food" "point_of_interest", "establishment" includedTypes 사용 및 excludedTypes를 사용하여 장소를 가리지 않습니다.

    일반적인 기본 유형을 지정하는 경우(예: "restaurant") 또는 "hotel"이면 응답에 더 많은 요소가 있는 장소가 포함될 수 있습니다. 특정 기본 유형을 선택합니다. 예를 들어 "restaurant"의 기본 유형을 포함합니다. 그러면 응답은 기본 유형이 "restaurant"인 장소를 포함하지만 응답에는 "chinese_restaurant" 또는 "seafood_restaurant"입니다.

    검색이 여러 유형 제한으로 지정된 경우 모든 제한사항을 충족하는 값이 반환됩니다. 예를 들어 includedTypes = Arrays.asList("restaurant") 및 excludedPrimaryTypes = Arrays.asList("steak_house"), 반환된 장소 중 "restaurant"개의 관련 서비스를 제공하지만 주로 영업하지 않는 장소 "steak_house"로 표현.

    includedTypes 및 excludedTypes를 사용하는 방법의 예는 다음을 참고하세요. 주변 검색 (신규) 요청.

    포함된 유형

    다음에서 가져온 장소 유형 목록: 검색할 표 A. 이 매개변수를 생략하면 모든 유형의 장소가 반환됩니다.

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

    제외된 유형

    다음의 장소 유형 목록: 표 A 검색

    includedTypes (예: "school") 및 excludedTypes (예: "primary_school")를 호출하면 "school"(으)로 분류되었지만 다음 카테고리로 분류되지 않은 장소가 포함된 응답 "primary_school"입니다. 응답에는 다음 중 하나 이상의 장소와 일치하는 장소가 포함됩니다. includedTypes 및 excludedTypes 없음.

    충돌하는 유형이 있는 경우(예: 두 includedTypes에 모두 나타나는 유형) excludedTypes이면 INVALID_REQUEST 오류가 반환됩니다.

    제외된 유형 매개변수를 설정하려면 SearchNearbyRequest 객체를 빌드할 때 setExcludedTypes() 메서드를 호출합니다.

    포함된 기본 유형

    다음의 기본 장소 유형 목록: 포함할 표 A 찾을 수 있습니다.

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

    제외된 기본 유형

    다음의 기본 장소 유형 목록: 제외할 표 A 찾을 수 있습니다.

    충돌하는 기본 유형이 있는 경우(예: includedPrimaryTypes 및 excludedPrimaryTypes, INVALID_ARGUMENT 오류가 반환됩니다.

    제외된 기본 유형 매개변수를 설정하려면 SearchNearbyRequest 객체를 빌드할 때 setExcludedPrimaryTypes() 메서드를 호출합니다.

  • 최대 결과 수

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

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

  • 순위 환경설정

    사용할 순위 유형입니다. 이 매개변수를 생략하면 검색 결과의 순위가 인기도에 따라 결정됩니다. 다음 중 하나일 수 있습니다.

    • POPULARITY (기본값): 인기도에 따라 결과를 정렬합니다.
    • DISTANCE 지정할 수 있습니다.

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

  • 지역 코드

    응답 형식을 지정하는 데 사용되는 지역 코드로, <ph type="x-smartling-placeholder"></ph> 2자리 CLDR 코드 값을 제공합니다. 기본값은 없습니다.

    응답의 formattedAddress 필드의 국가 이름이 regionCode인 경우 국가 코드가 formattedAddress에서 생략됩니다.

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

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

앱에 특성 표시

앱이 PlacesClient님, 앱은 필수 저작자 표시도 표시해야 합니다.

자세한 내용은 Places SDK 정책 Android