Usługa autouzupełniania w pakiecie Miejsca SDK na iOS zwraca prognozy w odpowiedzi na zapytania użytkowników. Gdy użytkownik wpisuje tekst, usługa autouzupełniania zwraca sugestie dotyczące miejsc takich jak firmy, adresy, kody plus i ciekawe miejsca.
Autouzupełnianie do dodawania do aplikacji jest następujące:
- Dodaj element sterujący autouzupełniania do interfejsu, aby skrócić czas programowania i zapewnić użytkownikom spójne wrażenia.
- Automatyczne pobieranie prognoz miejsc pozwala dostosować usługi do potrzeb użytkowników.
Dodawanie elementu sterującego autouzupełniania do interfejsu
Element sterujący autouzupełniania w interfejsie to okno wyszukiwania z wbudowaną funkcją autouzupełniania. Gdy użytkownik wpisuje wyszukiwane hasło, element sterujący wyświetla listę przewidywanych miejsc do wyboru. Gdy użytkownik dokona wyboru, zwracana jest instancja GMSPlace
, za pomocą której aplikacja może pobrać informacje o wybranym miejscu.
Element sterujący autouzupełniania interfejsu autouzupełniania możesz dodać do aplikacji na te sposoby:
- Dodawanie elementu sterującego na pełnym ekranie
- Dodawanie kontrolera wyników
- Używanie źródła danych tabeli
Dodawanie elementu sterującego pełnego ekranu
Użyj elementu sterującego pełnego ekranu, jeśli chcesz mieć kontekst modalny. Interfejs autouzupełniania tymczasowo zastępuje UI aplikacji do momentu, gdy użytkownik dokona wyboru. Ta funkcja jest udostępniana przez klasę GMSAutocompleteViewController
. Gdy użytkownik wybierze miejsce, aplikacja otrzyma oddzwonienie.
Aby dodać do aplikacji element sterujący na pełnym ekranie:
- Utwórz element interfejsu w głównej aplikacji, aby uruchomić element sterujący autouzupełniania, np. moduł obsługi dotyku w
UIButton
. - Zaimplementuj protokół
GMSAutocompleteViewControllerDelegate
w kontrolerze widoku nadrzędnego. - Utwórz instancję
GMSAutocompleteViewController
i przypisz nadrzędny kontroler widoku danych jako właściwość przedstawiciela. - Utwórz
GMSPlaceField
, aby określić typy danych miejsc, które mają być zwracane. - Dodaj element
GMSAutocompleteFilter
, aby ograniczyć zapytanie do określonego typu miejsca. - Prezentuj
GMSAutocompleteViewController
za pomocą[self presentViewController...]
. - Dokonaj wyboru użytkownika w metodzie przekazywania
didAutocompleteWithPlace
. - Zamknij kontroler w metodach przekazywania dostępu
didAutocompleteWithPlace
,didFailAutocompleteWithError
iwasCancelled
.
Przykład poniżej pokazuje jeden z możliwych sposobów uruchamiania GMSAutocompleteViewController
w odpowiedzi na kliknięcie przycisku.
Swift
import UIKit import GooglePlaces class ViewController: UIViewController { override func viewDidLoad() { makeButton() } // Present the Autocomplete view controller when the button is pressed. @objc func autocompleteClicked(_ sender: UIButton) { let autocompleteController = GMSAutocompleteViewController() autocompleteController.delegate = self // Specify the place data types to return. let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.name.rawValue) | UInt(GMSPlaceField.placeID.rawValue))! autocompleteController.placeFields = fields // Specify a filter. let filter = GMSAutocompleteFilter() filter.types = [.address] autocompleteController.autocompleteFilter = filter // Display the autocomplete view controller. present(autocompleteController, animated: true, completion: nil) } // Add a button to the view. func makeButton() { let btnLaunchAc = UIButton(frame: CGRect(x: 5, y: 150, width: 300, height: 35)) btnLaunchAc.backgroundColor = .blue btnLaunchAc.setTitle("Launch autocomplete", for: .normal) btnLaunchAc.addTarget(self, action: #selector(autocompleteClicked), for: .touchUpInside) self.view.addSubview(btnLaunchAc) } } extension ViewController: GMSAutocompleteViewControllerDelegate { // Handle the user's selection. func viewController(_ viewController: GMSAutocompleteViewController, didAutocompleteWith place: GMSPlace) { print("Place name: \(place.name)") print("Place ID: \(place.placeID)") print("Place attributions: \(place.attributions)") dismiss(animated: true, completion: nil) } func viewController(_ viewController: GMSAutocompleteViewController, didFailAutocompleteWithError error: Error) { // TODO: handle the error. print("Error: ", error.localizedDescription) } // User canceled the operation. func wasCancelled(_ viewController: GMSAutocompleteViewController) { dismiss(animated: true, completion: nil) } // Turn the network activity indicator on and off again. func didRequestAutocompletePredictions(_ viewController: GMSAutocompleteViewController) { UIApplication.shared.isNetworkActivityIndicatorVisible = true } func didUpdateAutocompletePredictions(_ viewController: GMSAutocompleteViewController) { UIApplication.shared.isNetworkActivityIndicatorVisible = false } }
Objective-C
#import "ViewController.h" @import GooglePlaces; @interface ViewController () <GMSAutocompleteViewControllerDelegate> @end @implementation ViewController { GMSAutocompleteFilter *_filter; } - (void)viewDidLoad { [super viewDidLoad]; [self makeButton]; } // Present the autocomplete view controller when the button is pressed. - (void)autocompleteClicked { GMSAutocompleteViewController *acController = [[GMSAutocompleteViewController alloc] init]; acController.delegate = self; // Specify the place data types to return. GMSPlaceField fields = (GMSPlaceFieldName | GMSPlaceFieldPlaceID); acController.placeFields = fields; // Specify a filter. _filter = [[GMSAutocompleteFilter alloc] init]; _filter.types = @[ kGMSPlaceTypeBank ]; acController.autocompleteFilter = _filter; // Display the autocomplete view controller. [self presentViewController:acController animated:YES completion:nil]; } // Add a button to the view. - (void)makeButton{ UIButton *btnLaunchAc = [UIButton buttonWithType:UIButtonTypeCustom]; [btnLaunchAc addTarget:self action:NSSelectorFromString(@"autocompleteClicked") forControlEvents:UIControlEventTouchUpInside]; [btnLaunchAc setTitle:@"Launch autocomplete" forState:UIControlStateNormal]; btnLaunchAc.frame = CGRectMake(5.0, 150.0, 300.0, 35.0); btnLaunchAc.backgroundColor = [UIColor blueColor]; [self.view addSubview:btnLaunchAc]; } // Handle the user's selection. - (void)viewController:(GMSAutocompleteViewController *)viewController didAutocompleteWithPlace:(GMSPlace *)place { [self dismissViewControllerAnimated:YES completion:nil]; // Do something with the selected place. NSLog(@"Place name %@", place.name); NSLog(@"Place ID %@", place.placeID); NSLog(@"Place attributions %@", place.attributions.string); } - (void)viewController:(GMSAutocompleteViewController *)viewController didFailAutocompleteWithError:(NSError *)error { [self dismissViewControllerAnimated:YES completion:nil]; // TODO: handle the error. NSLog(@"Error: %@", [error description]); } // User canceled the operation. - (void)wasCancelled:(GMSAutocompleteViewController *)viewController { [self dismissViewControllerAnimated:YES completion:nil]; } // Turn the network activity indicator on and off again. - (void)didRequestAutocompletePredictions:(GMSAutocompleteViewController *)viewController { [UIApplication sharedApplication].networkActivityIndicatorVisible = YES; } - (void)didUpdateAutocompletePredictions:(GMSAutocompleteViewController *)viewController { [UIApplication sharedApplication].networkActivityIndicatorVisible = NO; } @end
Dodawanie kontrolera wyników
Użyj kontrolera wyników, jeśli chcesz mieć większą kontrolę nad interfejsem wprowadzania tekstu. Kontroler wyników dynamicznie przełącza widoczność listy wyników w zależności od zaznaczenia w interfejsie użytkownika.
Aby dodać kontroler wyników do aplikacji:
- Utwórz
GMSAutocompleteResultsViewController
. - Zaimplementuj protokół
GMSAutocompleteResultsViewControllerDelegate
w kontrolerze widoku nadrzędnego i przypisz nadrzędny kontroler widoku danych jako właściwość przedstawicieli. - Utwórz obiekt
UISearchController
, przekazującGMSAutocompleteResultsViewController
jako argument kontrolera wyników. - Ustaw
GMSAutocompleteResultsViewController
jako właściwośćsearchResultsUpdater
elementuUISearchController
. - Dodaj do interfejsu aplikacji:
searchBar
dla elementuUISearchController
. - Dokonaj wyboru użytkownika w metodzie przekazywania
didAutocompleteWithPlace
.
Pasek wyszukiwania elementu UISearchController
możesz umieścić w interfejsie aplikacji na kilka sposobów:
- Dodawanie paska wyszukiwania do paska nawigacyjnego
- Dodawanie paska wyszukiwania na górze widoku
- Dodawanie paska wyszukiwania za pomocą wyskakującego okienka z wynikami
Dodawanie paska wyszukiwania do paska nawigacyjnego
Poniższy przykładowy kod przedstawia dodawanie kontrolera wyników, dodawanie elementu searchBar
do paska nawigacyjnego i obsługę wyboru użytkownika:
Swift
class ViewController: UIViewController { var resultsViewController: GMSAutocompleteResultsViewController? var searchController: UISearchController? var resultView: UITextView? override func viewDidLoad() { super.viewDidLoad() resultsViewController = GMSAutocompleteResultsViewController() resultsViewController?.delegate = self searchController = UISearchController(searchResultsController: resultsViewController) searchController?.searchResultsUpdater = resultsViewController // Put the search bar in the navigation bar. searchController?.searchBar.sizeToFit() navigationItem.titleView = searchController?.searchBar // When UISearchController presents the results view, present it in // this view controller, not one further up the chain. definesPresentationContext = true // Prevent the navigation bar from being hidden when searching. searchController?.hidesNavigationBarDuringPresentation = false } } // Handle the user's selection. extension ViewController: GMSAutocompleteResultsViewControllerDelegate { func resultsController(_ resultsController: GMSAutocompleteResultsViewController, didAutocompleteWith place: GMSPlace) { searchController?.isActive = false // Do something with the selected place. print("Place name: \(place.name)") print("Place address: \(place.formattedAddress)") print("Place attributions: \(place.attributions)") } func resultsController(_ resultsController: GMSAutocompleteResultsViewController, didFailAutocompleteWithError error: Error){ // TODO: handle the error. print("Error: ", error.localizedDescription) } // Turn the network activity indicator on and off again. func didRequestAutocompletePredictions(_ viewController: GMSAutocompleteViewController) { UIApplication.shared.isNetworkActivityIndicatorVisible = true } func didUpdateAutocompletePredictions(_ viewController: GMSAutocompleteViewController) { UIApplication.shared.isNetworkActivityIndicatorVisible = false } }
Objective-C
- (void)viewDidLoad { _resultsViewController = [[GMSAutocompleteResultsViewController alloc] init]; _resultsViewController.delegate = self; _searchController = [[UISearchController alloc] initWithSearchResultsController:_resultsViewController]; _searchController.searchResultsUpdater = _resultsViewController; // Put the search bar in the navigation bar. [_searchController.searchBar sizeToFit]; self.navigationItem.titleView = _searchController.searchBar; // When UISearchController presents the results view, present it in // this view controller, not one further up the chain. self.definesPresentationContext = YES; // Prevent the navigation bar from being hidden when searching. _searchController.hidesNavigationBarDuringPresentation = NO; } // Handle the user's selection. - (void)resultsController:(GMSAutocompleteResultsViewController *)resultsController didAutocompleteWithPlace:(GMSPlace *)place { _searchController.active = NO; // Do something with the selected place. NSLog(@"Place name %@", place.name); NSLog(@"Place address %@", place.formattedAddress); NSLog(@"Place attributions %@", place.attributions.string); } - (void)resultsController:(GMSAutocompleteResultsViewController *)resultsController didFailAutocompleteWithError:(NSError *)error { [self dismissViewControllerAnimated:YES completion:nil]; // TODO: handle the error. NSLog(@"Error: %@", [error description]); } // Turn the network activity indicator on and off again. - (void)didRequestAutocompletePredictionsForResultsController: (GMSAutocompleteResultsViewController *)resultsController { [UIApplication sharedApplication].networkActivityIndicatorVisible = YES; } - (void)didUpdateAutocompletePredictionsForResultsController: (GMSAutocompleteResultsViewController *)resultsController { [UIApplication sharedApplication].networkActivityIndicatorVisible = NO; }
Dodawanie paska wyszukiwania u góry widoku
Poniższy przykładowy kod pokazuje, jak dodać element searchBar
do górnej części widoku.
Swift
import UIKit import GooglePlaces class ViewController: UIViewController { var resultsViewController: GMSAutocompleteResultsViewController? var searchController: UISearchController? var resultView: UITextView? override func viewDidLoad() { super.viewDidLoad() resultsViewController = GMSAutocompleteResultsViewController() resultsViewController?.delegate = self searchController = UISearchController(searchResultsController: resultsViewController) searchController?.searchResultsUpdater = resultsViewController let subView = UIView(frame: CGRect(x: 0, y: 65.0, width: 350.0, height: 45.0)) subView.addSubview((searchController?.searchBar)!) view.addSubview(subView) searchController?.searchBar.sizeToFit() searchController?.hidesNavigationBarDuringPresentation = false // When UISearchController presents the results view, present it in // this view controller, not one further up the chain. definesPresentationContext = true } } // Handle the user's selection. extension ViewController: GMSAutocompleteResultsViewControllerDelegate { func resultsController(_ resultsController: GMSAutocompleteResultsViewController, didAutocompleteWith place: GMSPlace) { searchController?.isActive = false // Do something with the selected place. print("Place name: \(place.name)") print("Place address: \(place.formattedAddress)") print("Place attributions: \(place.attributions)") } func resultsController(_ resultsController: GMSAutocompleteResultsViewController, didFailAutocompleteWithError error: Error){ // TODO: handle the error. print("Error: ", error.localizedDescription) } // Turn the network activity indicator on and off again. func didRequestAutocompletePredictions(forResultsController resultsController: GMSAutocompleteResultsViewController) { UIApplication.shared.isNetworkActivityIndicatorVisible = true } func didUpdateAutocompletePredictions(forResultsController resultsController: GMSAutocompleteResultsViewController) { UIApplication.shared.isNetworkActivityIndicatorVisible = false } }
Objective-C
- (void)viewDidLoad { [super viewDidLoad]; _resultsViewController = [[GMSAutocompleteResultsViewController alloc] init]; _resultsViewController.delegate = self; _searchController = [[UISearchController alloc] initWithSearchResultsController:_resultsViewController]; _searchController.searchResultsUpdater = _resultsViewController; UIView *subView = [[UIView alloc] initWithFrame:CGRectMake(0, 65.0, 250, 50)]; [subView addSubview:_searchController.searchBar]; [_searchController.searchBar sizeToFit]; [self.view addSubview:subView]; // When UISearchController presents the results view, present it in // this view controller, not one further up the chain. self.definesPresentationContext = YES; } // Handle the user's selection. - (void)resultsController:(GMSAutocompleteResultsViewController *)resultsController didAutocompleteWithPlace:(GMSPlace *)place { [self dismissViewControllerAnimated:YES completion:nil]; // Do something with the selected place. NSLog(@"Place name %@", place.name); NSLog(@"Place address %@", place.formattedAddress); NSLog(@"Place attributions %@", place.attributions.string); } - (void)resultsController:(GMSAutocompleteResultsViewController *)resultsController didFailAutocompleteWithError:(NSError *)error { [self dismissViewControllerAnimated:YES completion:nil]; // TODO: handle the error. NSLog(@"Error: %@", [error description]); } // Turn the network activity indicator on and off again. - (void)didRequestAutocompletePredictionsForResultsController: (GMSAutocompleteResultsViewController *)resultsController { [UIApplication sharedApplication].networkActivityIndicatorVisible = YES; } - (void)didUpdateAutocompletePredictionsForResultsController: (GMSAutocompleteResultsViewController *)resultsController { [UIApplication sharedApplication].networkActivityIndicatorVisible = NO; }
Domyślnie UISearchController
ukrywa pasek nawigacyjny podczas prezentacji (ta opcja można wyłączyć). Jeśli pasek nawigacyjny jest widoczny i nieprzezroczysty, UISearchController
nieprawidłowo ustawia miejsce docelowe.
Aby obejść ten problem, użyj następującego kodu:
Swift
navigationController?.navigationBar.translucent = false searchController?.hidesNavigationBarDuringPresentation = false // This makes the view area include the nav bar even though it is opaque. // Adjust the view placement down. self.extendedLayoutIncludesOpaqueBars = true self.edgesForExtendedLayout = .top
Objective-C
self.navigationController.navigationBar.translucent = NO; _searchController.hidesNavigationBarDuringPresentation = NO; // This makes the view area include the nav bar even though it is opaque. // Adjust the view placement down. self.extendedLayoutIncludesOpaqueBars = YES; self.edgesForExtendedLayout = UIRectEdgeTop;
Dodawanie paska wyszukiwania za pomocą wyskakującego okienka z wynikami
Poniższy przykładowy kod pokazuje, jak umieścić pasek wyszukiwania po prawej stronie paska nawigacyjnego i wyświetlić wyniki w wyskakującym okienku.
Swift
import UIKit import GooglePlaces class ViewController: UIViewController { var resultsViewController: GMSAutocompleteResultsViewController? var searchController: UISearchController? var resultView: UITextView? override func viewDidLoad() { super.viewDidLoad() resultsViewController = GMSAutocompleteResultsViewController() resultsViewController?.delegate = self searchController = UISearchController(searchResultsController: resultsViewController) searchController?.searchResultsUpdater = resultsViewController // Add the search bar to the right of the nav bar, // use a popover to display the results. // Set an explicit size as we don't want to use the entire nav bar. searchController?.searchBar.frame = (CGRect(x: 0, y: 0, width: 250.0, height: 44.0)) navigationItem.rightBarButtonItem = UIBarButtonItem(customView: (searchController?.searchBar)!) // When UISearchController presents the results view, present it in // this view controller, not one further up the chain. definesPresentationContext = true // Keep the navigation bar visible. searchController?.hidesNavigationBarDuringPresentation = false searchController?.modalPresentationStyle = .popover } } // Handle the user's selection. extension ViewController: GMSAutocompleteResultsViewControllerDelegate { func resultsController(_ resultsController: GMSAutocompleteResultsViewController, didAutocompleteWith place: GMSPlace) { searchController?.isActive = false // Do something with the selected place. print("Place name: \(place.name)") print("Place address: \(place.formattedAddress)") print("Place attributions: \(place.attributions)") } func resultsController(_ resultsController: GMSAutocompleteResultsViewController, didFailAutocompleteWithError error: Error){ // TODO: handle the error. print("Error: ", error.localizedDescription) } // Turn the network activity indicator on and off again. func didRequestAutocompletePredictions(forResultsController resultsController: GMSAutocompleteResultsViewController) { UIApplication.shared.isNetworkActivityIndicatorVisible = true } func didUpdateAutocompletePredictions(forResultsController resultsController: GMSAutocompleteResultsViewController) { UIApplication.shared.isNetworkActivityIndicatorVisible = false } }
Objective-C
- (void)viewDidLoad { [super viewDidLoad]; _resultsViewController = [[GMSAutocompleteResultsViewController alloc] init]; _resultsViewController.delegate = self; _searchController = [[UISearchController alloc] initWithSearchResultsController:_resultsViewController]; _searchController.searchResultsUpdater = _resultsViewController; // Add the search bar to the right of the nav bar, // use a popover to display the results. // Set an explicit size as we don't want to use the entire nav bar. _searchController.searchBar.frame = CGRectMake(0, 0, 250.0f, 44.0f); self.navigationItem.rightBarButtonItem = [[UIBarButtonItem alloc] initWithCustomView:_searchController.searchBar]; // When UISearchController presents the results view, present it in // this view controller, not one further up the chain. self.definesPresentationContext = YES; // Keep the navigation bar visible. _searchController.hidesNavigationBarDuringPresentation = NO; _searchController.modalPresentationStyle = UIModalPresentationPopover; } // Handle the user's selection. - (void)resultsController:(GMSAutocompleteResultsViewController *)resultsController didAutocompleteWithPlace:(GMSPlace *)place { [self dismissViewControllerAnimated:YES completion:nil]; NSLog(@"Place name %@", place.name); NSLog(@"Place address %@", place.formattedAddress); NSLog(@"Place attributions %@", place.attributions.string); } - (void)resultsController:(GMSAutocompleteResultsViewController *)resultsController didFailAutocompleteWithError:(NSError *)error { [self dismissViewControllerAnimated:YES completion:nil]; // TODO: handle the error. NSLog(@"Error: %@", [error description]); } // Turn the network activity indicator on and off again. - (void)didRequestAutocompletePredictionsForResultsController: (GMSAutocompleteResultsViewController *)resultsController { [UIApplication sharedApplication].networkActivityIndicatorVisible = YES; } - (void)didUpdateAutocompletePredictionsForResultsController: (GMSAutocompleteResultsViewController *)resultsController { [UIApplication sharedApplication].networkActivityIndicatorVisible = NO; }
Korzystanie ze źródła danych tabeli
Jeśli Twoja aplikacja ma interfejs niestandardowego tekstu wyszukiwania, możesz użyć klasy GMSAutocompleteTableDataSource
, aby widok tabeli wyświetlał wyniki w kontrolerze widoku.
Aby używać GMSAutocompleteTableDataSource
jako źródła danych i przedstawicieli UITableView
w kontrolerze widoków:
- Zaimplementuj protokoły
GMSAutocompleteTableDataSourceDelegate
iUISearchBarDelegate
w kontrolerze widoków. - Utwórz instancję
GMSAutocompleteTableDataSource
i przypisz kontroler widoku danych jako właściwość przedstawicieli. - Ustaw
GMSAutocompleteTableDataSource
jako źródło danych i przekaż właściwości instancjiUITableView
w kontrolerze widoków. - W module obsługi wpisywania wyszukiwanego tekstu wywołaj
sourceTextHasChanged
naGMSAutocompleteTableDataSource
. - Dokonaj wyboru użytkownika w metodzie przekazywania dostępu
didAutocompleteWithPlace
. - Zamknij kontroler w metodach przekazywania dostępu
didAutocompleteWithPlace
,didFailAutocompleteWithError
iwasCancelled
.
Poniższy przykładowy kod pokazuje, jak użyć klasy GMSAutocompleteTableDataSource
do kierowania widoku tabeli UIViewController
, gdy UISearchBar
jest dodawany oddzielnie.
Swift
// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. import GooglePlaces import UIKit class PlaceAutocompleteViewController: UIViewController { private var tableView: UITableView! private var tableDataSource: GMSAutocompleteTableDataSource! override func viewDidLoad() { super.viewDidLoad() let searchBar = UISearchBar(frame: CGRect(x: 0, y: 20, width: self.view.frame.size.width, height: 44.0)) searchBar.delegate = self view.addSubview(searchBar) tableDataSource = GMSAutocompleteTableDataSource() tableDataSource.delegate = self tableView = UITableView(frame: CGRect(x: 0, y: 64, width: self.view.frame.size.width, height: self.view.frame.size.height - 44)) tableView.delegate = tableDataSource tableView.dataSource = tableDataSource view.addSubview(tableView) } } extension PlaceAutocompleteViewController: UISearchBarDelegate { func searchBar(_ searchBar: UISearchBar, textDidChange searchText: String) { // Update the GMSAutocompleteTableDataSource with the search text. tableDataSource.sourceTextHasChanged(searchText) } } extension PlaceAutocompleteViewController: GMSAutocompleteTableDataSourceDelegate { func didUpdateAutocompletePredictions(for tableDataSource: GMSAutocompleteTableDataSource) { // Turn the network activity indicator off. UIApplication.shared.isNetworkActivityIndicatorVisible = false // Reload table data. tableView.reloadData() } func didRequestAutocompletePredictions(for tableDataSource: GMSAutocompleteTableDataSource) { // Turn the network activity indicator on. UIApplication.shared.isNetworkActivityIndicatorVisible = true // Reload table data. tableView.reloadData() } func tableDataSource(_ tableDataSource: GMSAutocompleteTableDataSource, didAutocompleteWith place: GMSPlace) { // Do something with the selected place. print("Place name: \(place.name)") print("Place address: \(place.formattedAddress)") print("Place attributions: \(place.attributions)") } func tableDataSource(_ tableDataSource: GMSAutocompleteTableDataSource, didFailAutocompleteWithError error: Error) { // Handle the error. print("Error: \(error.localizedDescription)") } func tableDataSource(_ tableDataSource: GMSAutocompleteTableDataSource, didSelect prediction: GMSAutocompletePrediction) -> Bool { return true } }
Objective-C
// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. #import "PlaceAutocompleteViewController.h" @import GooglePlaces; @import UIKit; @interface PlaceAutocompleteViewController () <GMSAutocompleteTableDataSourceDelegate, UISearchBarDelegate> @end @implementation PlaceAutocompleteViewController { UITableView *tableView; GMSAutocompleteTableDataSource *tableDataSource; } - (void)viewDidLoad { [super viewDidLoad]; UISearchBar *searchBar = [[UISearchBar alloc] initWithFrame:CGRectMake(0, 20, self.view.frame.size.width, 44)]; searchBar.delegate = self; [self.view addSubview:searchBar]; tableDataSource = [[GMSAutocompleteTableDataSource alloc] init]; tableDataSource.delegate = self; tableView = [[UITableView alloc] initWithFrame:CGRectMake(0, 64, self.view.frame.size.width, self.view.frame.size.height - 44)]; tableView.delegate = tableDataSource; tableView.dataSource = tableDataSource; [self.view addSubview:tableView]; } #pragma mark - GMSAutocompleteTableDataSourceDelegate - (void)didUpdateAutocompletePredictionsForTableDataSource:(GMSAutocompleteTableDataSource *)tableDataSource { // Turn the network activity indicator off. UIApplication.sharedApplication.networkActivityIndicatorVisible = NO; // Reload table data. [tableView reloadData]; } - (void)didRequestAutocompletePredictionsForTableDataSource:(GMSAutocompleteTableDataSource *)tableDataSource { // Turn the network activity indicator on. UIApplication.sharedApplication.networkActivityIndicatorVisible = YES; // Reload table data. [tableView reloadData]; } - (void)tableDataSource:(GMSAutocompleteTableDataSource *)tableDataSource didAutocompleteWithPlace:(GMSPlace *)place { // Do something with the selected place. NSLog(@"Place name: %@", place.name); NSLog(@"Place address: %@", place.formattedAddress); NSLog(@"Place attributions: %@", place.attributions); } - (void)tableDataSource:(GMSAutocompleteTableDataSource *)tableDataSource didFailAutocompleteWithError:(NSError *)error { // Handle the error NSLog(@"Error %@", error.description); } - (BOOL)tableDataSource:(GMSAutocompleteTableDataSource *)tableDataSource didSelectPrediction:(GMSAutocompletePrediction *)prediction { return YES; } #pragma mark - UISearchBarDelegate - (void)searchBar:(UISearchBar *)searchBar textDidChange:(NSString *)searchText { // Update the GMSAutocompleteTableDataSource with the search text. [tableDataSource sourceTextHasChanged:searchText]; } @end
Dostosowywanie kolorów tekstu i tła
Kolory całego tekstu i tła możesz ustawić w interfejsie autouzupełniania, aby widżet lepiej pasował do wyglądu aplikacji. Kolory elementów sterujących interfejsu można ustawić na 2 sposoby:
- Przez używanie natywnego protokołu UIUI w systemie iOS do globalnego stylu interfejsu, tam gdzie jest to możliwe. Te ustawienia dotyczą wielu elementów sterujących interfejsu, ale nie wszystkich.
- Przez używanie metod pakietu SDK w klasach widżetu do ustawiania właściwości, które nie są obsługiwane przez protokół UIUI.
Zwykle aplikacja korzysta z kombinacji protokołu UIinterfejs i pakietu SDK. Ten diagram pokazuje, których elementów można określić styl:
Tabela poniżej zawiera listę wszystkich elementów interfejsu i wskazuje, jak każdy z nich powinien mieć styl (protokół UIVisual lub metoda SDK).
Element interfejsu | Metoda | Poradniki i styl |
---|---|---|
Odcień paska nawigacyjnego (w tle) | Protokół UIPrezentacja | Wywołaj setBarTintColor przez serwer proxy UINavigationBar . |
Kolor odcienia paska nawigacyjnego (wskaźnik tekstu paska wyszukiwania i przycisk Anuluj) | Protokół UIPrezentacja | Wywołaj setTintColor przez serwer proxy UINavigationBar . |
Kolor tekstu paska wyszukiwania | Protokół UIPrezentacja | Ustaw NSForegroundColorAttributeName w searchBarTextAttributes . |
Kolor odcienia paska wyszukiwania | Nie dotyczy | Pasek wyszukiwania jest półprzezroczysty i wyświetla się jako cieniowana wersja paska nawigacyjnego. |
Kolor tekstu symbolu zastępczego paska wyszukiwania (domyślny tekst wyszukiwania) | Protokół UIPrezentacja | Ustaw NSForegroundColorAttributeName w placeholderAttributes . |
Tekst podstawowy (stosowany też w przypadku błędu i tekstu komunikatu) | Metoda SDK | Zadzwoń do firmy primaryTextColor . |
Wyróżnienie tekstu głównego | Metoda SDK | Zadzwoń do firmy primaryTextHighlightColor . |
Tekst dodatkowy | Metoda SDK | Zadzwoń do firmy secondaryTextColor . |
Błąd i treść wiadomości | Metoda SDK | Zadzwoń do firmy primaryTextColor . |
Tło komórki tabeli | Metoda SDK | Zadzwoń do firmy tableCellBackgroundColor . |
Kolor separatora komórek tabeli | Metoda SDK | Zadzwoń do firmy tableCellSeparatorColor . |
Przycisk „Spróbuj ponownie” | Metoda SDK | Zadzwoń do firmy tintColor . |
Wskaźnik aktywności (wskaźnik postępu) | Protokół UIPrezentacja | Wywołaj setColor przez serwer proxy UIActivityIndicatorView . |
Logo „Technologia Google”, obraz „Smutna chmura” | Nie dotyczy | Wersja biała lub szara jest wybierana automatycznie na podstawie kontrastu tła. |
Ikony lupy i niejasnego tekstu w polu tekstowym na pasku wyszukiwania | Nie dotyczy | Aby określić styl, zastąp obrazy domyślne obrazami w wybranym kolorze. |
Korzystanie z protokołu UIinterfejs
Za pomocą protokołu UIUI można uzyskać serwer proxy wyglądu dla danego elementu interfejsu, za pomocą którego można później ustawić kolor tego elementu. Modyfikacja ma wpływ na wszystkie instancje danego elementu interfejsu. Na przykład w poniższym przykładzie kolor tekstu klas UITextField
zmienia się globalnie na zielony, gdy są one zawarte w elemencie UISearchBar
:
[[UITextField appearanceWhenContainedIn:[UISearchBar class], nil] setDefaultTextAttributes:@{NSForegroundColorAttributeName:[UIColor greenColor]}];
Więcej informacji o definiowaniu wartości kolorów znajdziesz w dokumentacji klasy UIColor.
Poniższe fragmenty kodu pokazują wszystkie polecenia serwera proxy, których należy używać do zmiany stylu wszystkich elementów sterujących autouzupełniania na pełnym ekranie. Dodaj ten kod do metody didFinishLaunchingWithOptions
w Appdelegate.m:
// Define some colors. UIColor *darkGray = [UIColor darkGrayColor]; UIColor *lightGray = [UIColor lightGrayColor]; // Navigation bar background. [[UINavigationBar appearance] setBarTintColor:darkGray]; [[UINavigationBar appearance] setTintColor:lightGray]; // Color of typed text in the search bar. NSDictionary *searchBarTextAttributes = @{ NSForegroundColorAttributeName: lightGray, NSFontAttributeName : [UIFont systemFontOfSize:[UIFont systemFontSize]] }; [UITextField appearanceWhenContainedInInstancesOfClasses:@[[UISearchBar class]]] .defaultTextAttributes = searchBarTextAttributes; // Color of the placeholder text in the search bar prior to text entry. NSDictionary *placeholderAttributes = @{ NSForegroundColorAttributeName: lightGray, NSFontAttributeName : [UIFont systemFontOfSize:[UIFont systemFontSize]] }; // Color of the default search text. // NOTE: In a production scenario, "Search" would be a localized string. NSAttributedString *attributedPlaceholder = [[NSAttributedString alloc] initWithString:@"Search" attributes:placeholderAttributes]; [UITextField appearanceWhenContainedInInstancesOfClasses:@[[UISearchBar class]]] .attributedPlaceholder = attributedPlaceholder; // Color of the in-progress spinner. [[UIActivityIndicatorView appearance] setColor:lightGray]; // To style the two image icons in the search bar (the magnifying glass // icon and the 'clear text' icon), replace them with different images. [[UISearchBar appearance] setImage:[UIImage imageNamed:@"custom_clear_x_high"] forSearchBarIcon:UISearchBarIconClear state:UIControlStateHighlighted]; [[UISearchBar appearance] setImage:[UIImage imageNamed:@"custom_clear_x"] forSearchBarIcon:UISearchBarIconClear state:UIControlStateNormal]; [[UISearchBar appearance] setImage:[UIImage imageNamed:@"custom_search"] forSearchBarIcon:UISearchBarIconSearch state:UIControlStateNormal]; // Color of selected table cells. UIView *selectedBackgroundView = [[UIView alloc] init]; selectedBackgroundView.backgroundColor = [UIColor lightGrayColor]; [UITableViewCell appearanceWhenContainedIn:[GMSAutocompleteViewController class], nil] .selectedBackgroundView = selectedBackgroundView;
Ustawianie właściwości stylu elementów sterujących interfejsu
Podzbiór elementów sterujących interfejsu użytkownika ma właściwości, na które nie ma wpływu protokół UIPreview, dlatego należy go ustawić bezpośrednio. Poniższy przykładowy kod pokazuje, jak zdefiniować kolory pierwszego planu i tła oraz zastosować je do instancji kontroli interfejsu o nazwie acController
. Dodaj ten kod do metody onLaunchClicked
w pliku ViewController.m:
UIColor *darkGray = [UIColor darkGrayColor]; UIColor *lightGray = [UIColor lightGrayColor]; acController.secondaryTextColor = [UIColor colorWithWhite:1.0f alpha:0.5f]; acController.primaryTextColor = lightGray; acController.primaryTextHighlightColor = [UIColor grayColor]; acController.tableCellBackgroundColor = darkGray; acController.tableCellSeparatorColor = lightGray; acController.tintColor = lightGray;
Automatyczne uzyskiwanie prognoz miejsc
Zamiast interfejsu użytkownika udostępnianego przez widżet autouzupełniania możesz utworzyć niestandardowy interfejs wyszukiwania. Aby to było możliwe, aplikacja musi automatycznie otrzymywać prognozy miejsc. Aplikacja może pobrać listę przewidywanych nazw miejsc lub adresów na jeden z tych sposobów:
Dzwonię pod GMSPlacesClient findAutocompletePredictionsFromQuery:
Aby uzyskać listę przewidywanych nazw miejsc lub adresów, najpierw zainstaluj usługę GMSPlacesClient, a następnie wywołaj metodę GMSPlacesClient findAutocompletePredictionsFromQuery:
z następującymi parametrami:
- Ciąg
autocompleteQuery
zawierający tekst wpisany przez użytkownika. GMSAutocompleteSessionToken
, który służy do identyfikowania poszczególnych sesji. Aplikacja powinna przekazywać ten sam token przy każdym wywołaniu żądania autouzupełniania, a następnie przekazać go wraz z identyfikatorem miejsca w kolejnym wywołaniu dofetchPlacefromPlaceID:
, aby pobrać szczegóły miejsca wybranego przez użytkownika.GMSAutocompleteFilter
do:- Promowanie lub ograniczanie wyników do konkretnego regionu.
- Ogranicz wyniki do określonego rodzaju miejsca.
- Obiekt
GMSPlaceLocationBias
/Restriction promujący wyniki do konkretnego obszaru określonego za pomocą szerokości i długości geograficznej.
- Metoda wywołania zwrotnego do obsługi zwróconych prognoz.
Przykłady kodu poniżej pokazują wywołanie findAutocompletePredictionsFromQuery:
.
Swift
/** * Create a new session token. Be sure to use the same token for calling * findAutocompletePredictions, as well as the subsequent place details request. * This ensures that the user's query and selection are billed as a single session. */ let token = GMSAutocompleteSessionToken.init() // Create a type filter. let filter = GMSAutocompleteFilter() filter.types = [.bank] filter.locationBias = GMSPlaceRectangularLocationOption( northEastBounds, southWestBounds); placesClient?.findAutocompletePredictions(fromQuery: "cheesebu", filter: filter, sessionToken: token, callback: { (results, error) in if let error = error { print("Autocomplete error: \(error)") return } if let results = results { for result in results { print("Result \(result.attributedFullText) with placeID \(result.placeID)") } } })
Objective-C
/** * Create a new session token. Be sure to use the same token for calling * findAutocompletePredictionsFromQuery:, as well as the subsequent place details request. * This ensures that the user's query and selection are billed as a single session. */ GMSAutocompleteSessionToken *token = [[GMSAutocompleteSessionToken alloc] init]; // Create a type filter. GMSAutocompleteFilter *_filter = [[GMSAutocompleteFilter alloc] init]; _filter.types = @[ kGMSPlaceTypeBank ]; [_placesClient findAutocompletePredictionsFromQuery:@"cheesebu" filter:_filter sessionToken:token callback:^(NSArray<GMSAutocompletePrediction *> * _Nullable results, NSError * _Nullable error) { if (error != nil) { NSLog(@"An error occurred %@", [error localizedDescription]); return; } if (results != nil) { for (GMSAutocompletePrediction *result in results) { NSLog(@"Result %@ with PlaceID %@", result.attributedFullText, result.placeID); } } }];
Interfejs API wywołuje określoną metodę wywołania zwrotnego, przekazując tablicę obiektów GMSAutocompletePrediction
.
Każdy obiekt GMSAutocompletePrediction
zawiera te informacje:
attributedFullText
– pełny tekst prognozy w postaciNSAttributedString
. np. „Sydney Opera House, Sydney, New South Wales, Australia”. Każdy zakres tekstu, który pasuje do danych wejściowych użytkownika, ma atrybutkGMSAutocompleteMatchAttribute
. Możesz użyć tego atrybutu, aby na przykład wyróżnić pasujący tekst w zapytaniu użytkownika, jak pokazano poniżej.placeID
– identyfikator prognozowanego miejsca. Identyfikator miejsca to tekstowy identyfikator, który jednoznacznie identyfikuje miejsce. Więcej informacji o identyfikatorach miejsc znajdziesz w omówieniu identyfikatorów miejsc.distanceMeters
– odległość w linii prostej z określonego miejsca (origin
) do miejsca docelowego. Jeśli właściwośćorigin
nie jest ustawiona, wartość odległości nie jest zwracana.
W tym przykładzie kodu widać, jak za pomocą funkcji enumerateAttribute
wyróżniać pogrubioną czcionką te części wyniku, które pasują do tekstu w zapytaniu użytkownika:
Swift
let regularFont = UIFont.systemFont(ofSize: UIFont.labelFontSize) let boldFont = UIFont.boldSystemFont(ofSize: UIFont.labelFontSize) let bolded = prediction.attributedFullText.mutableCopy() as! NSMutableAttributedString bolded.enumerateAttribute(kGMSAutocompleteMatchAttribute, in: NSMakeRange(0, bolded.length), options: []) { (value, range: NSRange, stop: UnsafeMutablePointer<ObjCBool>) -> Void in let font = (value == nil) ? regularFont : boldFont bolded.addAttribute(NSFontAttributeName, value: font, range: range) } label.attributedText = bolded
Objective-C
UIFont *regularFont = [UIFont systemFontOfSize:[UIFont labelFontSize]]; UIFont *boldFont = [UIFont boldSystemFontOfSize:[UIFont labelFontSize]]; NSMutableAttributedString *bolded = [prediction.attributedFullText mutableCopy]; [bolded enumerateAttribute:kGMSAutocompleteMatchAttribute inRange:NSMakeRange(0, bolded.length) options:0 usingBlock:^(id value, NSRange range, BOOL *stop) { UIFont *font = (value == nil) ? regularFont : boldFont; [bolded addAttribute:NSFontAttributeName value:font range:range]; }]; label.attributedText = bolded;
Korzystanie z modułu pobierania
Jeśli chcesz utworzyć od podstaw własną opcję autouzupełniania, możesz użyć GMSAutocompleteFetcher
, która opakowuje metodę autocompleteQuery
w elemencie GMSPlacesClient
.
Moduł pobierania ogranicza żądania, ponieważ zwraca tylko wyniki dotyczące ostatnio wpisanego wyszukiwanego tekstu. Nie zawiera żadnych elementów interfejsu.
Aby wdrożyć GMSAutocompleteFetcher
, wykonaj te czynności:
- Zaimplementuj protokół
GMSAutocompleteFetcherDelegate
. - Utwórz obiekt
GMSAutocompleteFetcher
. - Wywołuj metodę
sourceTextHasChanged
w module pobierania podczas wpisywania użytkownika. - Obsługuj prognozy i błędy za pomocą metod protokołów
didAutcompleteWithPredictions
ididFailAutocompleteWithError
.
Poniższy przykładowy kod pokazuje, jak korzystać z modułu pobierania do pobierania danych wejściowych użytkownika i wyświetlania dopasowań miejsc w widoku tekstu. Funkcja wyboru miejsca
została pominięta. FetcherSampleViewController
pochodzi z pliku UIViewController
w pliku FetcherSampleViewController.h.
Swift
import UIKit import GooglePlaces class ViewController: UIViewController { var textField: UITextField? var resultText: UITextView? var fetcher: GMSAutocompleteFetcher? override func viewDidLoad() { super.viewDidLoad() view.backgroundColor = .white edgesForExtendedLayout = [] // Set bounds to inner-west Sydney Australia. let neBoundsCorner = CLLocationCoordinate2D(latitude: -33.843366, longitude: 151.134002) let swBoundsCorner = CLLocationCoordinate2D(latitude: -33.875725, longitude: 151.200349) // Set up the autocomplete filter. let filter = GMSAutocompleteFilter() filter.locationRestriction = GMSPlaceRectangularLocationOption(neBoundsCorner, swBoundsCorner) // Create a new session token. let token: GMSAutocompleteSessionToken = GMSAutocompleteSessionToken.init() // Create the fetcher. fetcher = GMSAutocompleteFetcher(bounds: nil, filter: filter) fetcher?.delegate = self fetcher?.provide(token) textField = UITextField(frame: CGRect(x: 5.0, y: 10.0, width: view.bounds.size.width - 5.0, height: 64.0)) textField?.autoresizingMask = .flexibleWidth textField?.addTarget(self, action: #selector(textFieldDidChange(textField:)), for: .editingChanged) let placeholder = NSAttributedString(string: "Type a query...") textField?.attributedPlaceholder = placeholder resultText = UITextView(frame: CGRect(x: 0, y: 65.0, width: view.bounds.size.width, height: view.bounds.size.height - 65.0)) resultText?.backgroundColor = UIColor(white: 0.95, alpha: 1.0) resultText?.text = "No Results" resultText?.isEditable = false self.view.addSubview(textField!) self.view.addSubview(resultText!) } @objc func textFieldDidChange(textField: UITextField) { fetcher?.sourceTextHasChanged(textField.text!) } } extension ViewController: GMSAutocompleteFetcherDelegate { func didAutocomplete(with predictions: [GMSAutocompletePrediction]) { let resultsStr = NSMutableString() for prediction in predictions { resultsStr.appendFormat("\n Primary text: %@\n", prediction.attributedPrimaryText) resultsStr.appendFormat("Place ID: %@\n", prediction.placeID) } resultText?.text = resultsStr as String } func didFailAutocompleteWithError(_ error: Error) { resultText?.text = error.localizedDescription } }
Objective-C
#import "FetcherSampleViewController.h" #import <GooglePlaces/GooglePlaces.h> #import <GoogleMapsBase/GoogleMapsBase.h> @interface FetcherSampleViewController () <GMSAutocompleteFetcherDelegate> @end @implementation FetcherSampleViewController { UITextField *_textField; UITextView *_resultText; GMSAutocompleteFetcher* _fetcher; } - (void)viewDidLoad { [super viewDidLoad]; self.view.backgroundColor = [UIColor whiteColor]; self.edgesForExtendedLayout = UIRectEdgeNone; // Set bounds to inner-west Sydney Australia. CLLocationCoordinate2D neBoundsCorner = CLLocationCoordinate2DMake(-33.843366, 151.134002); CLLocationCoordinate2D swBoundsCorner = CLLocationCoordinate2DMake(-33.875725, 151.200349); GMSAutocompleteFilter *autocompleteFilter = [[GMSAutocompleteFilter alloc] init]; autocompleteFilter.locationRestriction = GMSPlaceRectangularLocationOption(neBoundsCorner, swBoundsCorner); // Create the fetcher. _fetcher = [[GMSAutocompleteFetcher alloc] initWithBounds:nil filter:filter]; _fetcher.delegate = self; // Set up the UITextField and UITextView. _textField = [[UITextField alloc] initWithFrame:CGRectMake(5.0f, 0, self.view.bounds.size.width - 5.0f, 44.0f)]; _textField.autoresizingMask = UIViewAutoresizingFlexibleWidth; [_textField addTarget:self action:@selector(textFieldDidChange:) forControlEvents:UIControlEventEditingChanged]; _resultText =[[UITextView alloc] initWithFrame:CGRectMake(0, 45.0f, self.view.bounds.size.width, self.view.bounds.size.height - 45.0f)]; _resultText.backgroundColor = [UIColor colorWithWhite:0.95f alpha:1.0f]; _resultText.text = @"No Results"; _resultText.editable = NO; [self.view addSubview:_textField]; [self.view addSubview:_resultText]; } - (void)textFieldDidChange:(UITextField *)textField { NSLog(@"%@", textField.text); [_fetcher sourceTextHasChanged:textField.text]; } #pragma mark - GMSAutocompleteFetcherDelegate - (void)didAutocompleteWithPredictions:(NSArray *)predictions { NSMutableString *resultsStr = [NSMutableString string]; for (GMSAutocompletePrediction *prediction in predictions) { [resultsStr appendFormat:@"%@\n", [prediction.attributedPrimaryText string]]; } _resultText.text = resultsStr; } - (void)didFailAutocompleteWithError:(NSError *)error { _resultText.text = [NSString stringWithFormat:@"%@", error.localizedDescription]; } @end
Tokeny sesji
Tokeny sesji grupują fazy zapytania i wyboru użytkownika autouzupełniania wyszukiwania w oddzielną sesję na potrzeby rozliczeń. Sesja zaczyna się, gdy użytkownik zaczyna wpisywać zapytanie, a kończy się, gdy wybiera miejsce. Każda sesja może zawierać wiele zapytań, po których następuje wybór jednego miejsca. Po zakończeniu sesji token traci ważność. Aplikacja musi wygenerować nowy token dla każdej sesji. Zalecamy używanie tokenów sesji we wszystkich sesjach autouzupełniania zautomatyzowanych (jeśli używasz kontrolera pełnoekranowego lub kontrolera wyników, interfejs API zrobi to automatycznie).
Pakiet SDK Miejsc na iOS używa elementu GMSAutocompleteSessionToken
do identyfikowania każdej sesji. Aplikacja powinna przekazywać nowy token sesji na początku każdej nowej sesji, a następnie przekazywać ten sam token wraz z identyfikatorem miejsca w kolejnym wywołaniu do fetchPlacefromPlaceID:
, aby pobrać szczegóły miejsca wybranego przez użytkownika.
Więcej informacji o tokenach sesji
Aby wygenerować nowy token sesji, użyj tego kodu:
let token: GMSAutocompleteSessionToken = GMSAutocompleteSessionToken.init()
Limity wykorzystania
- Korzystanie z metody
GMSPlacesClient findAutocompletePredictionsFromQuery
podlega zróżnicowanym limitom zapytań. Zapoznaj się z dokumentacją limitów wykorzystania.
Wyświetlanie atrybucji w aplikacji
- Jeśli aplikacja korzysta z usługi autouzupełniania w sposób zautomatyzowany, interfejs użytkownika musi wyświetlać oznaczenie „Technologia Google” lub wyświetlać się na mapie marki Google.
- Jeśli Twoja aplikacja korzysta z elementu sterującego autouzupełniania w interfejsie, nie musisz nic robić (wymagana atrybucja jest domyślnie wyświetlana).
- Jeśli po uzyskaniu miejsca według identyfikatora pobierasz i wyświetlasz dodatkowe informacje o miejscu, musisz też wyświetlać informacje o zewnętrznych atrybucjach.
Więcej informacji na ten temat znajdziesz w dokumentacji dotyczącej atrybucji.
Sterowanie wskaźnikiem aktywności w sieci
Aby kontrolować wskaźnik aktywności w sieci na pasku stanu aplikacji, musisz wdrożyć odpowiednie opcjonalne metody przekazywania dostępu do klasy autouzupełniania, których używasz, oraz samodzielnie włączyć i wyłączyć wskaźnik sieci.
- W przypadku
GMSAutocompleteViewController
musisz wdrożyć metody przekazywania dostępudidRequestAutocompletePredictions:
ididUpdateAutocompletePredictions:
. - W przypadku
GMSAutocompleteResultsViewController
musisz wdrożyć metody przekazywania dostępudidRequestAutocompletePredictionsForResultsController:
ididUpdateAutocompletePredictionsForResultsController:
. - W przypadku
GMSAutocompleteTableDataSource
musisz wdrożyć metody przekazywania dostępudidRequestAutocompletePredictionsForTableDataSource:
ididUpdateAutocompletePredictionsForTableDataSource:
.
Jeśli zaimplementujesz te metody i ustawisz [UIApplication sharedApplication].networkActivityIndicatorVisible
na YES
i NO
, pasek stanu będzie się poprawnie zgadzać z interfejsem autouzupełniania.
Ograniczanie wyników autouzupełniania
W interfejsie autouzupełniania możesz ustawić ograniczenie wyników do konkretnego regionu geograficznego lub filtrowanie ich według jednego bądź większej liczby typów miejsc albo do konkretnego kraju lub kraju. Aby ograniczyć wyniki, wykonaj te czynności:
- Aby preferować (odchylenia) w zdefiniowanym regionie, ustaw
locationBias
wGMSAutocompleteFilter
(niektóre wyniki spoza zdefiniowanego regionu mogą nadal być zwracane). Jeśli ustawiona jest też wartośćlocationRestriction
, zasadalocationBias
jest ignorowana. Aby wyświetlać tylko (ograniczać) wyniki z wyznaczonego regionu, ustaw w polu
GMSAutocompleteFilter
ustawienielocationRestriction
(zostaną zwrócone tylko wyniki ze wskazanego regionu).- Uwaga: to ograniczenie dotyczy tylko całych tras. Wyniki syntetyczne znajdujące się poza prostokątnymi granicami mogą być zwracane w przypadku trasy, która nakłada się na ograniczenie dotyczące lokalizacji.
Aby zwracać tylko wyniki zgodne z określonym typem miejsca, ustaw
types
w poluGMSAutocompleteFilter
(na przykład określenie filtra TypeFilter.ADDRESS spowoduje, że widżet zwróci wyniki tylko z precyzyjnym adresem).Aby zwracać tylko wyniki z maksymalnie 5 określonych krajów, w polu
GMSAutocompleteFilter
ustaw właściwośćcountries
.
Wyniki stronnicze w konkretnym regionie
Aby preferować (odchylenia) w zdefiniowanym regionie, ustaw locationBias
w GMSAutocompleteFilter
w następujący sposób:
northEast = CLLocationCoordinate2DMake(39.0, -95.0);
southWest = CLLocationCoordinate2DMake(37.5, -100.0);
GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.locationBias = GMSPlaceRectangularLocationOption(northEast, southWest);
Ograniczanie wyników do konkretnego regionu
Aby wyświetlać (ograniczać) wyniki tylko z wyznaczonego regionu, w polu GMSAutocompleteFilter
ustaw locationRestriction
w ten sposób:
northEast = CLLocationCoordinate2DMake(39.0, -95.0);
southWest = CLLocationCoordinate2DMake(37.5, -100.0);
GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.locationRestriction = GMSPlaceRectangularLocationOption(northEast, southWest);
Filtrowanie wyników według kraju
Aby filtrować wyniki z maksymalnie 5 wybranych krajów, ustaw countries
na GMSAutocompleteFilter
, jak pokazano tutaj:
GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.countries = @[ @"au", @"nz" ];
Filtrowanie wyników według typu miejsca lub kolekcji typów
Ogranicz wyniki do określonego typu lub zbieranych wyników, ustawiając właściwość types
na GMSAutoCompleteFilter
.
Ta właściwość pozwala określić filtry wymienione w tabelach 1, 2 i 3 dotyczące typów miejsc. Jeśli nic nie zostanie określone, zwracane będą wszystkie typy.
Aby określić typ lub filtr kolekcji typów:
Użyj właściwości
types
, aby określić maksymalnie 5 wartości type z tabel 1 i 2 widocznych w typach miejsc. Wartości typu są definiowane przez stałe wGMSPlaceType
.Użyj właściwości
types
, aby określić zbiór typów z tabeli 3 wyświetlanej w typach miejsc. Wartości zbioru typu są definiowane przez stałe wGMSPlaceType
.W żądaniu dozwolony jest tylko jeden typ z tabeli 3. Jeśli podasz wartość z tabeli 3, nie możesz podać wartości z tabeli 1 ani 2. Jeśli to zrobisz, wystąpi błąd.
Aby na przykład zwracać tylko wyniki zgodne z określonym typem miejsca, w polu GMSAutocompleteFilter
ustaw właściwość types
. Poniższy przykład pokazuje ustawienie filtra tak, aby zwracał tylko wyniki z dokładnym adresem:
GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.types = @[ kGMSPlaceTypeAirport, kGMSPlaceTypeAmusementPark ];
Optymalizacja autouzupełniania miejsc
W tej sekcji opisujemy sprawdzone metody, które pomogą Ci w pełni wykorzystać możliwości usługi autouzupełniania miejsc.
Oto kilka ogólnych wskazówek:
- Najszybszym sposobem opracowania działającego interfejsu użytkownika jest użycie widżetu autouzupełniania interfejsu Maps JavaScript API, widżetu autouzupełniania w usłudze Places SDK na Androida lub elementu autouzupełniania interfejsu Places SDK dla iOS.
- Opanuj od samego początku najważniejsze pola danych autouzupełniania miejsc.
- Pola promowania lokalizacji i ograniczeń lokalizacji są opcjonalne, ale mogą mieć znaczny wpływ na wydajność autouzupełniania.
- Użyj obsługi błędów, aby zapewnić płynne działanie aplikacji w przypadku zwrócenia błędu przez interfejs API.
- Zadbaj o to, aby aplikacja działała, gdy nie ma możliwości wyboru, i umożliwiała użytkownikom kontynuowanie.
Sprawdzone metody optymalizacji kosztów
Podstawowa optymalizacja kosztów
Aby zoptymalizować koszty korzystania z usługi autouzupełniania miejsc, użyj masek pól w szczegółach miejsca, a widżety autouzupełniania miejsc zwracają tylko potrzebne pola danych miejsc.
Zaawansowana optymalizacja kosztów
Rozważ automatyczną implementację autouzupełniania miejsc, aby uzyskiwać dostęp do cen według żądania i wysyłać żądania wyników z interfejsu Geocoding API dotyczące wybranego miejsca zamiast szczegółów miejsca. Ceny za żądanie w połączeniu z interfejsem Geocoding API są bardziej opłacalne niż ceny za sesję (na podstawie sesji), jeśli spełnione są oba te warunki:
- Jeśli potrzebujesz tylko szerokości i długości geograficznej lub adresu wybranego przez użytkownika, interfejs Geocoding API dostarczy te informacje w czasie krótszym niż wywołanie Place Details.
- Jeśli użytkownicy wybiorą podpowiedź autouzupełniania średnio w ciągu maksymalnie 4 żądań prognozy autouzupełniania, model cenowy za żądanie może być bardziej opłacalny niż model cenowy za sesję.
Czy Twoja aplikacja wymaga podania innych informacji niż adres i szerokość geograficzna wybranej prognozy?
Tak, potrzebuję więcej szczegółów
Użyj autouzupełniania miejsc na podstawie sesji z wykorzystaniem szczegółów miejsca.
Aplikacja wymaga informacji o miejscu, takich jak nazwa miejsca, status firmy lub godziny otwarcia, więc implementacja autouzupełniania miejsc powinna korzystać z tokena sesji (automatycznie lub wbudowanego w widżety JavaScript, Androida bądź iOS). Całkowity koszt to 0, 017 USD za sesję plus odpowiednie kody SKU danych miejsc w zależności od żądanych pól danych miejsc.
Implementacja widżetów
Zarządzanie sesjami jest automatycznie wbudowane w widżety JavaScript oraz Androida i iOS. Obejmuje to zarówno żądania autouzupełniania miejsc, jak i żądanie informacji o miejscu w przypadku wybranej prognozy. Pamiętaj o określeniu parametru fields
, aby mieć pewność, że wysyłasz tylko te pola danych miejsc, których potrzebujesz.
Implementacja automatyczna
W przypadku żądań autouzupełniania miejsc używaj tokena sesji. Wysyłając żądanie informacji o miejscu dla wybranej prognozy, podaj te parametry:
- identyfikator miejsca z odpowiedzi autouzupełniania miejsc,
- Token sesji używany w żądaniu autouzupełniania miejsca.
- Parametr
fields
określający pola danych miejsc, których potrzebujesz.
Nie, potrzebna jest tylko lokalizacja i adres
Interfejs Geocoding API może być tańszy niż w przypadku aplikacji Szczegóły miejsca, w zależności od wydajności korzystania z funkcji autouzupełniania. Skuteczność autouzupełniania poszczególnych aplikacji różni się w zależności od tego, co wpisują użytkownicy, gdzie dana aplikacja jest używana i czy wdrożono sprawdzone metody optymalizacji wydajności.
Aby odpowiedzieć na to pytanie, sprawdź, ile znaków średnio wpisuje użytkownik, zanim wybierzesz podpowiedź autouzupełniania miejsca w aplikacji.
Czy użytkownicy wybierają średnio 4 podpowiedzi autouzupełniania miejsca w maksymalnie 4 żądaniach?
Tak
Zaimplementuj autouzupełnianie miejsc automatycznie bez tokenów sesji i wywołaj interfejs Geocoding API dla wybranej prognozy miejsca.
Geocoding API dostarcza adresów i współrzędnych szerokości i długości geograficznej za 0,005 USD za każde żądanie. Wykonanie czterech żądań autouzupełniania miejsc – na żądanie kosztuje 0,01132 USD, więc łączny koszt 4 żądań i wywołania Geocoding API dla prognozy wybranego miejsca wynosi 0,01632 USD, czyli mniej niż 0,017 USD za sesję, czyli 0,017 USD za sesję1.
Rozważ zastosowanie sprawdzonych metod dotyczących skuteczności, aby użytkownicy mogli wyświetlać oczekiwane przez nich podpowiedzi przy użyciu jeszcze mniejszej liczby znaków.
Nie
Użyj autouzupełniania miejsc na podstawie sesji z wykorzystaniem szczegółów miejsca.
Ze względu na to, że średnia liczba żądań, które spodziewasz się wysłać przed wybraniem prognozy autouzupełniania miejsca przez użytkownika, przekracza koszt na sesję, dlatego Twoja implementacja autouzupełniania miejsc powinna używać tokena sesji zarówno w przypadku żądań autouzupełniania miejsc, jak i powiązanych z nimi żądania szczegółów miejsca.Łączny koszt wynosi 0,017 za sesję1.
Implementacja widżetów
Zarządzanie sesjami jest automatycznie wbudowane w widżety JavaScript oraz Androida i iOS. Obejmuje to zarówno żądania autouzupełniania miejsc, jak i żądanie informacji o miejscu w przypadku wybranej prognozy. Określ parametr fields
, by mieć pewność, że wysyłasz tylko żądania danych podstawowych.
Implementacja automatyczna
W przypadku żądań autouzupełniania miejsc używaj tokena sesji. Wysyłając żądanie informacji o miejscu dla wybranej prognozy, podaj te parametry:
- identyfikator miejsca z odpowiedzi autouzupełniania miejsc,
- Token sesji używany w żądaniu autouzupełniania miejsca.
- Parametr
fields
określający pola danych podstawowych, takich jak adres i geometria
Rozważ opóźnianie żądań autouzupełniania miejsc
Możesz na przykład opóźnić żądanie autouzupełniania miejsca do momentu, w którym użytkownik wpisze pierwsze 3–4 znaki. Dzięki temu aplikacja będzie wysyłać mniej żądań. Na przykład wysyłanie żądań autouzupełniania miejsc dla każdego znaku po wpisaniu trzeciego znaku przez użytkownika oznacza, że jeśli użytkownik wpisze 7 znaków, a następnie wybierze prognozę, dla której utworzysz jedno żądanie do interfejsu Geocoding API, łączny koszt wyniesie 0,01632 USD (4 * 0,00283 USD za autouzupełnianie na żądanie + 0,005 geokodowania)1.
Jeśli opóźnione żądania pozwalają uzyskać średnią wartość żądania zautomatyzowanego poniżej 4, postępuj zgodnie ze wskazówkami dotyczącymi implementacji wydajnego autouzupełniania miejsc z użyciem interfejsu Geocoding API. Pamiętaj, że żądania opóźnione mogą być postrzegane jako czas oczekiwania dla użytkowników, którzy mogą oczekiwać podpowiedzi po każdym naciśnięciu klawisza.
Rozważ zastosowanie sprawdzonych metod dotyczących skuteczności, aby użytkownicy mogli otrzymywać oczekiwane przez nich prognozy w mniejszej liczbie znaków.
-
Wymienione tutaj koszty są podane w dolarach amerykańskich. Pełne informacje o cenach znajdziesz na stronie Rozliczenia za Google Maps Platform.
Sprawdzone metody zwiększania skuteczności
Poniższe wskazówki opisują sposoby optymalizacji skuteczności autouzupełniania miejsc:
- Dodaj do implementacji autouzupełniania miejsc ograniczenia związane z krajem, promowaniem lokalizacji i (w przypadku implementacji automatycznej) ustawienia języka. Preferencje językowe nie są potrzebne w przypadku widżetów, ponieważ określają one język w przeglądarce lub na urządzeniu mobilnym użytkownika.
- Jeśli autouzupełnianiem miejsc towarzyszy mapa, możesz odchylać lokalizację według widocznego obszaru mapy.
- Jeśli użytkownik nie wybierze żadnej z podpowiedzi autouzupełniania (zwykle nie jest to adres pożądanego adresu), możesz ponownie użyć pierwotnych danych wejściowych użytkownika, aby uzyskać trafniejsze wyniki:
- Jeśli oczekujesz, że użytkownik będzie wpisywać tylko informacje adresowe, użyj tych samych danych w wywołaniu interfejsu Geocoding API.
- Jeśli oczekujesz, że użytkownik będzie wpisywać zapytania dotyczące konkretnego miejsca, wpisując jego nazwę lub adres, skorzystaj z prośby o znajdowanie miejsca. Jeśli wyniki są oczekiwane tylko w konkretnym regionie, użyj promowania lokalizacji.
- Użytkownicy wpisują adresy podrzędne w krajach, w których autouzupełnianie miejsc nie obsługuje adresów podrzędnych, np. w Czechach, Estonii i Litwie. Na przykład czeski adres „Stroupežnického 3191/17, Praha” generuje częściowe podpowiedzi w ramach autouzupełniania miejsc.
- Użytkownicy, którzy wpisują adresy z prefiksem segmentu drogi, np. „23-30 29th St, Queens” w Nowym Jorku lub „47-380 Kamehameha Hwy, Kaneohe” na wyspie Kauai na Hawai'i.
Rozwiązywanie problemów
Błędy mogą się pojawiać bardzo różne Więcej informacji na temat limitów znajdziesz w sekcji Limity wykorzystania.
Błędy występujące podczas korzystania z elementów sterujących autouzupełniania są zwracane w metodzie didFailAutocompleteWithError()
różnych protokołów przekazywania dostępu. Właściwość code
dostarczonego obiektu NSError
jest ustawiona na jedną z wartości wyliczenia GMSPlacesErrorCode
.