주변 검색 (신규)

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

주변 검색 (신규) 요청은 검색할 지역을 입력으로 받아들입니다. 은 원으로 지정되며, 원과 반경(미터)입니다. 요청은 일치하는 장소의 목록을 반환하며, 각 목록은 GMSPlace 드림 객체에 대한 검색 결과를 반환할 수 있습니다.

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

주변 검색 (신규) 요청

다음을 호출하여 주변 검색 요청 GMSPlacesClient searchNearbyWithRequest:님, 전달 GMSPlaceSearchNearbyRequest 객체는 GMSPlaceSearchNearbyResultCallback님, 응답을 처리합니다

GMSPlaceSearchNearbyRequest 객체는 필수 및 선택사항 매개변수를 제공합니다. 필수 매개변수는 다음과 같습니다.

  • GMSPlace 객체에서 반환할 필드의 목록으로, 필드 마스크, 즉 GMSPlaceProperty 필드 목록에 필드를 하나 이상 지정하지 않거나 필드 목록에 없으면 호출이 오류를 반환합니다.
  • 위치 제한: 검색 지역을 정의하는 원입니다.

이 근처 검색 요청 예시는 응답 GMSPlace 객체가 장소 이름 (GMSPlacePropertyName) 및 장소 좌표 포함 검색에 포함된 각 GMSPlace 객체에 대한 (GMSPlacePropertyCoordinate) 있습니다. 또한 응답을 필터링하여 '음식점' 유형의 장소만 반환합니다. '카페'입니다.

Swift

// Array to hold the places in the response
var placeResults: [GMSPlace] = []

// Define the search area as a 500 meter diameter circle in San Francisco, CA.
let circularLocationRestriction = GMSPlaceCircularLocationOption(CLLocationCoordinate2DMake(37.7937, -122.3965), 500)

// Specify the fields to return in the GMSPlace object for each place in the response.
let placeProperties = [GMSPlaceProperty.name, GMSPlaceProperty.coordinate].map {$0.rawValue}

// Create the GMSPlaceSearchNearbyRequest, specifying the search area and GMSPlace fields to return.
var request = GMSPlaceSearchNearbyRequest(locationRestriction: circularLocationRestriction, placeProperties: placeProperties)
let includedTypes = ["restaurant", "cafe"]
request.includedTypes = includedTypes

let callback: GMSPlaceSearchNearbyResultCallback = { [weak self] results, error in
  guard let self, error == nil else {
    if let error {
      print(error.localizedDescription)
    }
    return
  }
  guard let results = results as? [GMSPlace] else {
    return
  }
  placeResults = results
}

GMSPlacesClient.shared().searchNearby(with: request, callback: callback)

Objective-C

// Array to hold the places in the response
_placeResults = [NSArray array];

// Define the search area as a 500 meter diameter circle in San Francisco, CA.
id<GMSPlaceLocationRestriction> circularLocation = GMSPlaceCircularLocationOption(CLLocationCoordinate2DMake(37.7937, -122.3965), 500);

// Create the GMSPlaceSearchNearbyRequest, specifying the search area and GMSPlace fields to return.
GMSPlaceSearchNearbyRequest *request = [[GMSPlaceSearchNearbyRequest alloc]
  initWithLocationRestriction:circularLocation
              placeProperties:@[ GMSPlacePropertyName, GMSPlacePropertyCoordinate ]];

// Set the place types to filter on.
NSArray<NSString *> *includedTypes = @[ @"restaurant", @"cafe" ];
request.includedTypes = [[NSMutableArray alloc] initWithArray:includedTypes];

[_placesClient searchNearbyWithRequest:request
  callback:^(NSArray<GMSPlace *> *_Nullable places, NSError *_Nullable error) {
    if (error != nil) {
      NSLog(@"An error occurred %@", [error localizedDescription]);
      return;
    } else {
        // Get list of places.
        _placeResults = places;
    }
  }
];

iOS용 Places Swift SDK (미리보기)

let restriction = CircularCoordinateRegion(center: CLLocationCoordinate2DMake(37.7937, -122.3965), radius: 500)
let searchNearbyRequest = SearchNearbyRequest(
  locationRestriction: restriction,
  placeProperties: [ .name, .coordinate],
  includedTypes: [ .restaurant, .cafe ],
)
switch await placesClient.searchNearby(with: searchNearbyRequest) {
case .success(let places):
  // Handle places
case .failure(let placesError):
  // Handle error
}

주변 검색 응답

Nearby Search API는 일치하는 항목의 배열을 GMSPlace 드림 객체로서 일치하는 장소당 1개의 GMSPlace 객체가 있습니다.

영업 개시 상태 가져오기

GMSPlacesClient 객체에는 호출에 지정된 시간을 기준으로 장소가 현재 영업 중인지 나타내는 응답을 반환하는 isOpenWithRequest (Swift의 경우 isOpenRequest, GooglePlacesSwift의 경우 isPlaceOpenRequest)라는 멤버 함수가 포함되어 있습니다.

이 메서드는 다음을 포함하는 GMSPlaceIsOpenWithRequest 유형의 단일 인수를 사용합니다.

  • GMSPlace 객체 또는 장소 ID를 지정하는 문자열. 필수 필드를 사용하여 Place 객체를 만드는 방법에 관한 자세한 내용은 장소 세부정보를 참고하세요.
  • 확인할 시간을 지정하는 선택적 NSDate (Obj-C) 또는 Date (Swift) 객체입니다. 시간을 지정하지 않으면 기본값은 지금입니다.
  • 응답을 처리하는 GMSPlaceOpenStatusResponseCallback 메서드
    • &gt;
를 통해 개인정보처리방침을 정의할 수 있습니다.

GMSPlaceIsOpenWithRequest 메서드를 사용하려면 GMSPlace 객체에 다음 필드를 설정해야 합니다.

  • GMSPlacePropertyUTCOffsetMinutes
  • GMSPlacePropertyBusinessStatus
  • GMSPlacePropertyOpeningHours
  • GMSPlacePropertyCurrentOpeningHours
  • GMSPlacePropertySecondaryOpeningHours

이러한 필드가 장소 객체에 제공되지 않거나 장소 ID를 전달하는 경우 메서드는 GMSPlacesClient GMSFetchPlaceRequest:를 사용하여 필드를 가져옵니다.

응답 isOpenWithRequest개

isOpenWithRequest는 비즈니스가 영업 중인지, 폐업했는지 또는 상태를 알 수 없는지를 나타내는 불리언 값 status이 포함된 GMSPlaceIsOpenResponse 객체를 반환합니다.

언어 열려 있는 경우 값 닫힌 경우의 값 상태를 알 수 없는 경우 값
Swift .open .closed .unknown
Objective-C GMSPlaceOpenStatusOpen GMSPlaceOpenStatusClosed GMSPlaceOpenStatusUnknown
GooglePlacesSwift (미리보기) true false nil

isOpenWithRequest 결제

  • GMSPlacePropertyUTCOffsetMinutes 및 GMSPlacePropertyBusinessStatus 필드는 Basic Data SKU에 따라 요금이 청구됩니다. 남은 영업시간은 Place Details (Advanced) SKU에 따라 요금이 청구됩니다.
  • GMSPlace 객체에 이전 요청의 해당 필드가 이미 포함되어 있으면 다시 청구되지 않습니다.

예: GMSPlaceIsOpenWithRequest 요청 실행

다음 예는 기존 GMSPlace 객체 내에서 GMSPlaceIsOpenWithRequest를 초기화하는 방법을 보여줍니다.

Swift

    let isOpenRequest = GMSPlaceIsOpenRequest(place: place, date: nil)
      GMSPlacesClient.shared().isOpen(with: isOpenRequest) { response, error in
        if let error = error {
          // Handle Error
        }
        switch response.status {
          case .open:
            // Handle open
          case .closed:
            // Handle closed
          case .unknown:
            // Handle unknown
        }
      }

Objective-C

          GMSPlaceIsOpenRequest *isOpenRequest = [[GMSPlaceIsOpenRequest alloc] initWithPlace:place date:nil];
  
          [[GMSPlacesClient sharedClient] isOpenWithRequest:isOpenRequest callback:^(GMSPlaceIsOpenResponse response, NSError *_Nullable error) {
            if (error) {
              // Handle error
            }
  
            switch (response.status) {
              case GMSPlaceOpenStatusOpen:
                // Handle open
              case GMSPlaceOpenStatusClosed:
                // Handle closed
              case GMSPlaceOpenStatusUnknown:
                // Handle unknown
            }
          }];

GooglePlacesSwift

          let isOpenRequest = IsPlaceOpenRequest(place: place)
          switch await placesClient.isPlaceOpen(with: isOpenRequest) {
            case .success(let isOpenResponse):
              switch isOpenResponse.status {
                case true:
                  // Handle open
                case false:
                  // Handle closed
                case nil:
                  // Handle unknown
            case .failure(let placesError):
              // Handle error
          }

필수 매개변수

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

  • 필드 목록

    장소 세부정보를 요청할 때 데이터를 지정해야 합니다. 장소의 GMSPlace 객체에 필드 마스크로 반환됩니다. 포드의 필드 마스크를 사용하려면 GMSPlaceProperty GMSPlaceSearchNearbyRequest 객체에 추가합니다. 필드 마스킹은 불필요한 데이터를 요청하지 않도록 하는 불필요한 처리 시간과 요금 청구를 방지할 수 있습니다.

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

    • 다음 필드는 Nearby Search (Basic) SKU:

      GMSPlacePropertyAddressComponents, GMSPlacePropertyBusinessStatus, GMSPlacePropertyCoordinate, GMSPlacePropertyFormattedAddress님, GMSPlacePropertyName, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyPhotos, GMSPlacePropertyPlaceID, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyViewport, GMSPlacePropertyWheelchairAccessibleEntrance

    • 다음 필드는 Nearby Search (Advanced) SKU:

      GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours, GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel님, GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

    • 다음 필드는 Nearby Search (Preferred) SKU:

      GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary님, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

    다음 예는 두 개의 필드 값 를 사용하여 요청에서 반환된 GMSPlace 객체에 name 및 placeID 필드:

    Swift

    // Specify the place data types to return.
let fields: [GMSPlaceProperty] = [.placeID, .name]

    Objective-C

    // Specify the place data types to return.
NSArray<GMSPlaceProperty *> *fields = @[GMSPlacePropertyPlaceID, GMSPlacePropertyName];

    iOS용 Places Swift SDK (미리보기)

    // Specify the place data types to return.
let fields: [PlaceProperty] = [.placeID, .displayName]

  • locationRestriction

    GMSPlaceLocationRestriction 원으로 지정되고 중심점으로 정의되는 검색할 영역을 정의하는 객체입니다. 반경(미터) 반경은 0.0 이상, 50000.0 이하여야 합니다. 기본 반경은 0.0입니다. 요청에서 0.0보다 큰 값으로 설정해야 합니다.

선택적 매개변수

GMSPlaceSearchNearbyRequest 객체를 사용하여 다음과 같은 선택적 매개변수를 지정합니다. 검색

  • includeTypes/excludedTypes, includePrimaryTypes/excludedPrimaryTypes

    유형에서 유형 목록을 지정할 수 있음 필터링에 사용되는 표 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": ["restaurant"], "excludedPrimaryTypes": ["steak_house"]}, 반환된 장소에서는 "restaurant"개의 관련 서비스를 제공하지만 주로 영업하지 않는 경우 "steak_house"로 표현.

    includedTypes

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

    excludedTypes

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

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

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

    includedPrimaryTypes

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

    excludedPrimaryTypes

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

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

  • maxResultCount

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

  • rankPreference

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

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

  • regionCode

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

    응답의 formattedAddress 필드의 국가 이름이 regionCode인 경우 국가 코드가 formattedAddress에서 생략됩니다. 이 매개변수는 항상 국가를 포함하는 adrFormatAddress에는 영향을 미치지 않습니다. 이름 또는 shortFormattedAddress(포함되지 않음)에 있어야 합니다.

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

앱에 특성 표시

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

예를 들어 GMSPlacesClient 객체의 reviews 속성입니다. 최대 다섯 개의 GMSPlaceReview 객체입니다. 각 GMSPlaceReview 객체에는 속성 및 작성자 속성이 포함될 수 있습니다. 앱에서 리뷰를 표시하는 경우 저작자 표시나 작성자도 표시해야 합니다. 저작자 표시입니다.

자세한 내용은 기여 분석이 있습니다.