Place Autocomplete (신규)

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

자동 완성 (신규) 서비스는 iOS API로서 는 요청에 대한 응답으로 장소 추천을 반환합니다. 요청에서 텍스트 검색 문자열과 검색 영역을 제어하는 지리적 경계가 포함됩니다.

자동 완성 (신규) 서비스는 완전히 일치시킬 수 있습니다. 입력의 단어 및 하위 문자열, 장소 이름, 주소, + 코드를 참조하세요. 따라서 애플리케이션에서는 사용자가 즉시 장소 추천을 제공합니다.

장소 추천은 비즈니스, 주소, 업체와 같은 관심 분야로 이루어져 있습니다.

예를 들어, 부분적 오류가 포함된 문자열을 입력으로 사용하여 API를 호출합니다. 사용자 입력 'Spagh'를 입력했고 검색 영역은 뉴욕시로 제한됩니다. 응답에는 검색어와 일치하는 장소 추천의 목록이 포함됩니다. 문자열 및 검색 영역(예: '카페 스파게티'라는 식당)을 장소에 대한 세부정보도 표시됩니다.

반환된 장소 추천은 원하는 장소를 선택할 수 있습니다. 장소 세부정보 (신규) 추가 기능 요청 반환된 장소 추천에 대한 정보입니다.

자동 완성 (신규) 요청

다음에서 메서드를 호출하여 자동 완성 요청을 만듭니다. GMSPlaceClient 다음과 같이 매개변수를 전달할 수 있습니다. GMSAutocompleteRequest 객체를 지정합니다. 응답은 GMSAutocompletePlaceSuggestion 객체를 지정합니다.

API 키와 query 매개변수는 필수입니다. 또한 GMSAutocompleteSessionToken 요청을 결제 세션과 연결하고 GMSAutocompleteFilter 결과를 적용할 수 있습니다.

필수 및 선택적 매개변수에 대한 자세한 내용은 이 문서의 매개변수 섹션을 참고하세요.

Swift

let token = GMSAutocompleteSessionToken()

let northWestBounds = CLLocationCoordinate2DMake(40.921628, -73.700051)
let southEastBounds = CLLocationCoordinate2DMake(40.477398, -74.259087)

let filter = GMSAutocompleteFilter()
filter.types = [kGMSPlaceTypeRestaurant]
filter.locationBias = GMSPlaceRectangularLocationOption(northWestBounds, southEastBounds)
    
let request = GMSAutocompleteRequest(query:"Spagh")
request.filter = filter
request.sessionToken = token

GMSPlacesClient.shared().fetchAutocompleteSuggestions(from: request, callback: { ( results, error ) in
      if let error = error {
        print("Autocomplete error: \(error)")
        return
      }
      if let autocompleteResults = results {
        for result in autocompleteResults {
          print("Result \(String(describing: result.placeSuggestion?.placeID)) with \(String(describing: result.placeSuggestion?.attributedFullText))")
        }
      }
    })

Objective-C

CLLocationCoordinate2D northEast = CLLocationCoordinate2DMake(37.388162, -122.088137);
CLLocationCoordinate2D southWest = CLLocationCoordinate2DMake(37.395804, -122.077023);

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.types = @[ kGMSPlaceTypeRestaurant ];
filter.locationBias = GMSPlaceRectangularLocationOption(northEast, southWest);
GMSAutocompleteRequest *request = [[GMSAutocompleteRequest alloc] initWithQuery:@"Sicilian piz"];
request.sessionToken = token;
request.filter = filter;

[[GMSPlacesClient sharedClient] fetchAutocompleteSuggestionsFromRequest:request callback:^(NSArray<GMSAutocompleteSuggestion *> * results, NSError * error){
  // Handle response
  for (GMSAutocompleteSuggestion *suggestion in results) {
    if (suggestion.placeSuggestion) {
      // Show place suggestion data.
    }
  }
}];

GooglePlacesSwift

let center = (37.3913916, -122.0879074)
let northEast = (37.388162, -122.088137)
let southWest = (37.395804, -122.077023)

let bias = RectangularCoordinateRegion(northEast: northEast, southWest: southWest)
let filter = AutocompleteFilter(types: [ .restaurant ], origin: center, coordinateRegionBias: bias)

let autocompleteRequest = AutocompleteRequest(query: "Sicilian piz", filter: filter)
switch await placesClient.fetchAutocompleteSuggestions(with: autocompleteRequest) {
case .success(let autocompleteSuggestions):
  // Handle suggestions.
case .failure(let placesError):
  // Handle error.
}

자동 완성 (신규) 응답

자동 완성은 최대 다섯 개의 GMSAutocompleteSuggestion 인스턴스. 배열에는 다음이 포함됩니다.

  • placeID
  • types: 이 장소에 적용되는 유형
  • distanceMeters: 출발지로부터의 거리
  • attributedFullText: 사람이 읽을 수 있는 전체 추천 텍스트입니다.
  • attributedPrimaryText: 사람이 읽을 수 있는 추천 검색어의 기본 텍스트입니다.
  • attributedSecondaryText: 사람이 읽을 수 있는 추천의 보조 텍스트입니다.
  • structuredFormat: 구체적인 이름과 구체적인 텍스트(예: 도시 또는 리전으로 나뉩니다

필수 매개변수

검색어

검색할 텍스트 문자열입니다. 전체 단어 및 하위 문자열 지정, 장소 이름, 주소 및 플러스 코드가 포함됩니다. 이 자동 완성 (신규) 서비스가 일치 후보를 반환함 검색된 관련성에 따라 검색 결과를 정렬합니다.

선택적 매개변수

유형

장소는 테이블 유형에서 단일 기본 유형만 포함할 수 있습니다. A 또는 표 B에 연결됩니다. 예를 들어 기본 유형은 mexican_restaurant 또는 steak_house일 수 있습니다.

기본적으로 API는 input 매개변수를 기반으로 모든 장소를 반환합니다. 은 장소와 관련된 기본 유형 값과 관계없이 입니다. 결과 제한 특정 기본 유형 또는 기본 유형이 되도록 types 매개변수

이 매개변수를 사용하여 Table(표)에서 최대 5개의 유형 값을 지정합니다. A 또는 표 B. 장소가 일치해야 합니다. 응답에 포함될 지정된 기본 유형 값 중 하나

다음과 같은 경우 INVALID_REQUEST 오류와 함께 요청이 거부됩니다.

  • 5개 이상의 유형이 지정되었습니다.
  • 인식할 수 없는 유형이 모두 지정되었습니다.

국가

배열로 지정된 지정된 지역 목록의 결과만 포함합니다. 최대 15ccTLD('최상위' 도메인') 2자(영문 기준) 값이어야 합니다. 생략할 경우 응답에 제한이 적용되지 않습니다. 예를 들어 리전을 독일과 프랑스로 제한하는 방법은 다음과 같습니다.

Swift

let filter = GMSAutocompleteFilter()
filter.countries = ["DE", "FR"]

Objective-C

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.countries = @[ @"DE", @"FR" ];

GooglePlacesSwift

let filter = AutocompleteFilter(countries: ["DE", "FR"])

locationRestriction와 countries를 모두 지정하면 결과는 다음과 같습니다. 두 설정이 교차하는 영역에 있습니다.

inputOffset

커서 위치를 나타내는 0 기준 유니코드 문자 오프셋 input 커서 위치는 반환되는 예상 검색어에 영향을 줄 수 있습니다. 만약 비어 있으면 기본값은 input의 길이입니다.

locationBias 또는 locationRestriction

locationBias 또는 locationRestriction을 지정할 수 있지만 둘 다 지정할 수는 없습니다. 검색할 수 있습니다. locationRestriction는 결과는 내에 있어야 하며 locationBias는 결과는 근처에 있어야 하지만 해당 지역 밖에 있을 수 있습니다.

  • locationBias는 검색할 영역을 지정합니다. 이 위치는 편향 역할을 하며 즉, 다음을 포함하여 지정된 위치에 대한 결과가 반환될 수 있습니다. 결과가 지정된 영역을 벗어납니다.

  • locationRestriction는 검색할 영역을 지정합니다. 다음의 결과 반환되지 않습니다.

locationBias 또는 locationRestriction 리전을 직사각형으로 지정 표시 영역 또는 원으로 표시됩니다.

원은 중심점과 반지름(미터)으로 정의됩니다. 반경은 0.0 이상 50000.0 이하입니다. 기본값은 0.0입니다. 대상 locationRestriction인 경우 반경을 0.0보다 큰 값으로 설정해야 합니다. 그렇지 않으면 요청에서 결과가 반환되지 않습니다.

예를 들면 다음과 같습니다.

Swift

let center = CLLocationCoordinate2DMake(40.730610, -73.935242)
let radius = 1000.0

filter.locationBias = GMSPlaceCircularLocationOption(center, radius)

Objective-C

CLLocationCoordinate2D center = CLLocationCoordinate2DMake(40.730610, -73.935242);
radius = 1000.0;

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.locationBias = GMSPlaceCircularLocationOption(center, radius);

GooglePlacesSwift

let center = CLLocationCoordinate2DMake(40.477398, -74.259087)

let bias = CircularCoordinateRegion(center: center, radius: 1000.0)

let filter = AutocompleteFilter(coordinateRegionBias: bias)

직사각형은 대각선으로 두 개로 표시되는 위도-경도 표시 영역입니다. 반대 low 및 high점 표시 영역은 닫힌 영역으로 간주되며 즉, 해당 경계가 포함됩니다. 위도 경계 범위는 -90 ~ 범위는 90도이며, 경도 경계는 -180에서 180 사이여야 합니다. 도(포함):

  • low = high인 경우 표시 영역은 단일 점으로 구성됩니다.
  • low.longitude > high.longitude, 경도 범위가 반전됩니다( 경도 180도 선을 가로지르는 표시 영역입니다.
  • low.longitude = -180도이고 high.longitude= 180도이면 모든 경도가 포함되어 있습니다.
  • low.longitude = 180도이고 high.longitude = -180도이면 경도 범위가 비어 있습니다.

low와 high를 모두 채워야 하며, 표시된 상자는 비어 있습니다. 표시 영역이 비어 있으면 오류가 발생합니다.

예를 들어 이 표시 영역은 뉴욕시를 완전히 둘러쌉니다.

Swift

let high = CLLocationCoordinate2DMake(40.921628, -73.700051)
let low = CLLocationCoordinate2DMake(40.477398, -74.259087)

let filter = GMSAutocompleteFilter()
filter.locationBias = GMSPlaceRectangularLocationOption(high, low)

Objective-C

CLLocationCoordinate2D high = CLLocationCoordinate2DMake(40.477398, -74.259087);
CLLocationCoordinate2D low = CLLocationCoordinate2DMake(440.921628, -73.700051);

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.locationBias = GMSPlaceRectangularLocationOption(high, low);

GooglePlacesSwift

let northEast = CLLocationCoordinate2DMake(40.477398, -74.259087)
let southWest = CLLocationCoordinate2DMake(40.921628, -73.700051)

let filter = AutocompleteFilter(coordinateRegionBias: bias)

출처

지점까지의 직선 거리를 계산할 출발지입니다. 대상 (distanceMeters로 반환됨) 이 값을 생략하면 직선 거리는 반환되지 않습니다. 위도로 지정해야 하며 경도 좌표:

Swift

let filter = GMSAutocompleteFilter()
filter.origin =  CLLocation(latitude: 37.395804, longitude: -122.077023)

Objective-C

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];

filter.origin = [[CLLocation alloc] initWithLatitude:37.395804 longitude: -122.077023];

GooglePlacesSwift

let filter = AutocompleteFilter(origin: CLLocation(latitude: 37.395804, longitude: -122.077023))

regionCode

응답 형식을 지정하는 데 사용된 지역 코드로, ccTLD('최상위 수준' 도메인') 2자리 문자 값입니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하며 몇 가지 주목할 만한 예외가 있습니다 예를 들어 영국의 ccTLD는 'uk'입니다. (.co.uk), ISO 3166-1 코드는 'gb'입니다. (기술적으로 ' 영국 및 북아일랜드).

잘못된 지역 코드를 지정하면 API에서 INVALID_ARGUMENT 값을 반환합니다. 오류가 발생했습니다. 매개변수는 관련 법률에 따라 결과에 영향을 미칠 수 있습니다.

sessionToken

세션 토큰은 사용자 생성 문자열로, 통화를 '세션'으로 자동 완성 (신규)합니다. Autocomplete (신규)는 세션 토큰을 사용하여 사용자 자동 완성 검색의 쿼리 및 선택 단계를 개별 세션으로 사용할 수 없습니다. 자세한 내용은 세션 토큰을 사용합니다.

자동 완성 (신규) 예시

locationRestriction 및 locationBias 사용

자동 완성 (신규)은 기본적으로 IP 바이어스를 사용하여 검색 영역을 제어할 수 있습니다. IP 상세 검색을 통해 API는 결과를 편중할 수 있습니다. 원하는 경우 locationRestriction 또는 locationBias 중 하나로 지정 검색할 영역

위치 제한은 검색할 지역을 지정합니다. 지정된 범위를 벗어난 결과 반환되지 않습니다. 다음 예에서는 위치 제한을 사용하여 중심 반경 5000m인 원형 위치 제한에 대한 요청 샌프란시스코:

Swift

let token = GMSAutocompleteSessionToken()

let center = CLLocationCoordinate2DMake(37.775061, -122.419400)
let radius = 5000.0

let filter = GMSAutocompleteFilter()
filter.locationRestriction = GMSPlaceCircularLocationOption(center, radius)
    
let request = GMSAutocompleteRequest(query:"Piz")
request.filter = filter
request.sessionToken = token

GMSPlacesClient.shared().fetchAutocompleteSuggestions(from: request, callback: { ( results, error ) in
      if let error = error {
        print("Autocomplete error: \(error)")
        return
      }
      if let autocompleteResults = results {
        for result in autocompleteResults {
          print("Result \(String(describing: result.placeSuggestion?.placeID)) with \(String(describing: result.placeSuggestion?.attributedFullText))")
        }
      }
    })

Objective-C


CLLocationCoordinate2D center = CLLocationCoordinate2DMake(37.775061, -122.419400);
radius = 5000.0;

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.locationRestriction = GMSPlaceCircularLocationOption(center, radius);
GMSAutocompleteRequest *request = [[GMSAutocompleteRequest alloc] initWithQuery:@"Sicilian piz"];
request.sessionToken = token;
request.filter = filter;

[[GMSPlacesClient sharedClient] fetchAutocompleteSuggestionsFromRequest:request callback:^(NSArray<GMSAutocompleteSuggestion *> * results, NSError * error){
  // Handle response
  for (GMSAutocompleteSuggestion *suggestion in results) {
    if (suggestion.placeSuggestion) {
      // Show place suggestion data.
    }
  }
}];

GooglePlacesSwift

let center = (37.775061, -122.419400)
let radius = 5000.0
let restriction = CircularCoordinateRegion(center: center, radius: radius)
let filter = AutocompleteFilter(coordinateRegionRestriction: restriction)
let token = AutocompleteSessionToken()

let autocompleteRequest = AutocompleteRequest(query: "Sicilian piz", sessionToken: token, filter: filter)
switch await placesClient.fetchAutocompleteSuggestions(with: autocompleteRequest) {
case .success(let autocompleteSuggestions):
  for suggestion in autocompleteSuggestions {
    switch suggestion {
    case .place:
      // Show place suggestion data.
    }
  }
case .failure(let placesError):
  // Handle error.
}

위치 상세 정보를 사용하면 해당 위치가 특정 지역이나 주변 지역의 결과를 지정된 위치를 반환할 수 있으며, 여기에는 지정된 영역입니다. 다음 예는 위치 상세 검색을 사용하도록 이전 요청을 변경합니다.

Swift

let token = GMSAutocompleteSessionToken()

let center = CLLocationCoordinate2DMake(37.775061, -122.419400)
let radius = 5000.0

let filter = GMSAutocompleteFilter()
filter.locationBias = GMSPlaceCircularLocationOption(center, radius)
    
let request = GMSAutocompleteRequest(query:"Piz")
request.filter = filter
request.sessionToken = token

GMSPlacesClient.shared().fetchAutocompleteSuggestions(from: request, callback: { ( results, error ) in
      if let error = error {
        print("Autocomplete error: \(error)")
        return
      }
      if let autocompleteResults = results {
        for result in autocompleteResults {
          print("Result \(String(describing: result.placeSuggestion?.placeID)) with \(String(describing: result.placeSuggestion?.attributedFullText))")
        }
      }
    })

Objective-C

CLLocationCoordinate2D center = CLLocationCoordinate2DMake(37.775061, -122.419400);
radius = 5000.0;

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.locationBias = GMSPlaceCircularLocationOption(center, radius);
GMSAutocompleteRequest *request = [[GMSAutocompleteRequest alloc] initWithQuery:@"Sicilian piz"];
request.sessionToken = token;
request.filter = filter;

[[GMSPlacesClient sharedClient] fetchAutocompleteSuggestionsFromRequest:request callback:^(NSArray<GMSAutocompleteSuggestion *> * results, NSError * error){
  // Handle response
  for (GMSAutocompleteSuggestion *suggestion in results) {
    if (suggestion.placeSuggestion) {
      // Show place suggestion data.
    }
  }
}];

GooglePlacesSwift

let center = (37.775061, -122.419400)
let radius = 5000.0
let bias = CircularCoordinateRegion(center: center, radius: radius)
let filter = AutocompleteFilter(coordinateRegionBias: bias)
let token = AutocompleteSessionToken()

let autocompleteRequest = AutocompleteRequest(query: "Sicilian piz", sessionToken: token, filter: filter)
switch await placesClient.fetchAutocompleteSuggestions(with: autocompleteRequest) {
case .success(let autocompleteSuggestions):
  for suggestion in autocompleteSuggestions {
    switch suggestion {
    case .place:
      // Show place suggestion data.
    }
  }
case .failure(let placesError):
  // Handle error.
}

사용 유형

요청 결과를 특정 범위로 제한하려면 유형 매개변수를 사용합니다. 표 A 및 표 B. 포드의 최대 다섯 개 값의 배열입니다. 생략하면 모든 유형이 반환됩니다.

다음 예는 'Sucer'라는 쿼리 문자열을 지정합니다. 를 사용하고 결과를 유형의 시설로 제한하는 매개변수 "sporting_goods_store":

Swift

let token = GMSAutocompleteSessionToken()

let filter = GMSAutocompleteFilter()
filter.types = ["sporting_goods_store"]
    
let request = GMSAutocompleteRequest(query:"Soccer")
request.filter = filter
request.sessionToken = token

GMSPlacesClient.shared().fetchAutocompleteSuggestions(from: request, callback: { ( results, error ) in
      if let error = error {
        print("Autocomplete error: \(error)")
        return
      }
      if let autocompleteResults = results {
        for result in autocompleteResults {
          print("Result \(String(describing: result.placeSuggestion?.placeID)) with \(String(describing: result.placeSuggestion?.attributedFullText))")
        }
      }
    })

Objective-C

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.types = @[ "sporting_goods_store" ];
GMSAutocompleteRequest *request = [[GMSAutocompleteRequest alloc] initWithQuery:@"Soccer"];
request.sessionToken = token;
request.filter = filter;

[[GMSPlacesClient sharedClient] fetchAutocompleteSuggestionsFromRequest:request callback:^(NSArray<GMSAutocompleteSuggestion *> * results, NSError * error){
  // Handle response
  for (GMSAutocompleteSuggestion *suggestion in results) {
    if (suggestion.placeSuggestion) {
      // Show place suggestion data.
    }
  }
}];

GooglePlacesSwift

let filter = AutocompleteFilter(types: [ PlaceType(rawValue: "sporting_goods_store") ])
let token = AutocompleteSessionToken()

let autocompleteRequest = AutocompleteRequest(query: "Soccer", sessionToken: token, filter: filter)
switch await placesClient.fetchAutocompleteSuggestions(with: autocompleteRequest) {
case .success(let autocompleteSuggestions):
  for suggestion in autocompleteSuggestions {
    switch suggestion {
    case .place:
      // Show place suggestion data.
    }
  }
case .failure(let placesError):
  // Handle error.
}

출처 사용

요청에 origin 매개변수를 포함하면 다음과 같이 지정됩니다. 위도 및 경도 좌표의 경우, API에는 직선 거리가 포함됩니다. 도착지로 전달되는 경로를 나타냅니다. 응답은 거리를 distanceMeters로 설정합니다.

다음 예는 원점을 샌프란시스코의 중심으로 설정합니다.

Swift

let token = GMSAutocompleteSessionToken()

let origin = CLLocation(latitude: 37.7749, longitude: -122.4194)

let filter = GMSAutocompleteFilter()

filter.origin =  origin
    
let request = GMSAutocompleteRequest(query:"Amoeba")
request.filter = filter
request.sessionToken = token

GMSPlacesClient.shared().fetchAutocompleteSuggestions(from: request, callback: { ( results, error ) in
      if let error = error {
        print("Autocomplete error: \(error)")
        return
      }
      if let autocompleteResults = results {
        for result in autocompleteResults {
          print("Result \(String(describing: result.placeSuggestion?.placeID)) with \(String(describing: result.placeSuggestion?.attributedFullText)) and distance: \(String(describing: result.placeSuggestion?.distanceMeters))")
        }
      }
    })

Objective-C


GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.origin = [[CLLocation alloc] initWithLatitude:37.395804 longitude:-122.077023];
GMSAutocompleteRequest *request = [[GMSAutocompleteRequest alloc] initWithQuery:@"Amoeba"];
request.sessionToken = token;
request.filter = filter;

[[GMSPlacesClient sharedClient] fetchAutocompleteSuggestionsFromRequest:request callback:^(NSArray<GMSAutocompleteSuggestion *> * results, NSError * error){
  // Handle response
  for (GMSAutocompleteSuggestion *suggestion in results) {
    if (suggestion.placeSuggestion) {
      // Show place suggestion data.
      }
    }
}];

GooglePlacesSwift

let filter = AutocompleteFilter(origin: CLLocation(latitude: 37.7749, longitude: -122.4194))
let token = AutocompleteSessionToken()

let autocompleteRequest = AutocompleteRequest(query: "Amoeba", sessionToken: token, filter: filter)
switch await placesClient.fetchAutocompleteSuggestions(with: autocompleteRequest) {
case .success(let autocompleteSuggestions):
  for suggestion in autocompleteSuggestions {
    switch suggestion {
    case .place:
      // Show place suggestion data.
    }
  }
case .failure(let placesError):
  // Handle error.
}

기여 분석

자동 완성 (신규)은 있습니다. 지도를 표시하는 경우에는 반드시 Google 지도를 사용해야 합니다. 디스플레이하는 경우 자동 완성 (신규) 서비스의 추천 검색어 지도가 없는 경우 검색어와 나란히 표시된 Google 로고를 포함해야 합니다. 필드/결과를 지정할 수 있습니다. 자세한 내용은 Google 로고 및 저작자 표시에 관해 자세히 알아보세요.