Odniesienie do klasy GMSPlacesClient

Publiczne funkcje członkowskie | Statyczne publiczne funkcje członkowskie | Powiązane funkcje
Odniesienie do klasy GMSPlacesClient

Przegląd

Główny interfejs pakietu SDK Miejsc.

Służy do wyszukiwania i otrzymywania informacji o miejscach. Dostęp do tej klasy należy uzyskać przy użyciu metody [GMSPlacesClient sharedClient].

Metody GMSPlacesClient powinny być wywoływane tylko z wątku głównego. Wywołanie tych metod z innego wątku spowoduje wyjątek lub niezdefiniowane zachowanie. Jeśli nie określono inaczej, wszystkie wywołania zwrotne będą wywoływane w wątku głównym.

Publiczne funkcje członków

(void) – lookUpPlaceID:callback:
 Pobierz szczegóły miejsca.
(void) – lookUpPhotosForPlaceID:callback:
 Pobiera metadane maksymalnie 10 zdjęć powiązanych z miejscem.
(void) – loadPlacePhoto:callback:
 Powoduje wczytywanie określonego zdjęcia w maksymalnym rozmiarze.
(void) – loadPlacePhoto:constrainedToSize:scale:callback:
 Wczytuje zdjęcie określonego zdjęcia, przeskalowane w celu dopasowania do podanych maksymalnych wymiarów.
(void) – currentPlaceWithCallback:
 Zwraca przybliżone miejsce, w którym obecnie znajduje się urządzenie.
(void) - findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
 Sprawdzanie podpowiedzi autouzupełniania na podstawie zapytań tekstowych.
(void) - fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
 Pobierz szczegółowe informacje o miejscu.
(void) - findPlaceFormlihoodsFromCurrentLocationWithPlaceFields:callback:
 Określ prawdopodobne miejsce na podstawie bieżącej lokalizacji użytkownika.
(void) – isOpenWithPlaceID:callback:
 Pobiera informacje o danym miejscu, w tym wszystkie pola niezbędne do określenia obiektu GMSPlaceOpenStatus w bieżącym czasie.
(void) – isOpenWithPlaceID:date:callback:
 Pobiera informacje o miejscu, w tym wszystkie pola niezbędne do określenia GMSPlaceOpenStatus w określonym NSDate.
(void) – isOpenWithPlace:callback:
 Pobiera informacje o danym miejscu, w tym wszystkie pola niezbędne do określenia obiektu GMSPlaceOpenStatus w bieżącym czasie.
(void) – isOpenWithPlace:date:callback:
 Pobiera informacje o miejscu, w tym wszystkie pola niezbędne do określenia GMSPlaceOpenStatus w określonym NSDate.
(void) – searchByTextWithRequest:callback:
 Wyszukuj miejsca według tekstu i ograniczeń.

Statyczne publiczne funkcje członkowskie

(typ instancji)+ sharedClient
 Udostępnia współdzielone wystąpienie GMSPlacesClient na potrzeby pakietu SDK Miejsc Google na iOS, tworząc w razie potrzeby.
(BOOL) + provideAPIKey:
 Dostarcza klucz interfejsu API do pakietu SDK Miejsc Google na iOS.
(NSString *)+ openSourceLicenseInfo
 Zwraca informacje o licencji open source pakietu SDK Miejsc Google na iOS.
(NSString *)+ SDKVersion
 Zwraca wersję tej wersji pakietu SDK Miejsc Google na iOS.
(NSString *)+ SDKLongVersion
 Zwraca długą wersję tej wersji pakietu SDK Miejsc Google na iOS.

Pamiętaj, że nie są to funkcje składowe.

typedef void(^ GMSPlaceResultCallback )(GMSPlace *_Nullable result, NSError *_Nullable error)
 Typ wywołania zwrotnego do otrzymywania wyszukiwań szczegółów miejsca.
typedef void(^ GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList *_Nullable RisingList, NSError *_Nullable Prevention)
 Typ wywołania zwrotnego dla otrzymywania list prawdopodobieństwa związanego z miejscem.
typedef void(^ GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > *_Nullable rabats, NSError *_Nullable Error)
 Typ wywołania zwrotnego dla tablicy odbierającej o długości GMSPlaceLikelihood s.
typedef void(^ GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_NullableError)
 Typ wywołania zwrotnego dla otrzymywania wyników autouzupełniania.
typedef void(^ GMSPlacePhotoMetadataResultCallback )(GMSPlacePhotoMetadataList *__Nullable photos, NSError *_Nullable error)
 Typ wywołania zwrotnego dla wyników wyszukiwania zdjęć miejsc.
typedef void(^ GMSPlacePhotoImageResultCallback )(UIImage *_zdjęcie z możliwością pominięcia, NSError *_błąd wartościowy)
 Typ wywołania zwrotnego do odbierania obiektów UIImage z obiektu GMSPlacePhotoMetadata.
typedef void(^ GMSPlaceOpenStatusCallback )(wynik GMSPlaceOpenStatus, NSError *_Nullable)
 Typ oddzwaniania, aby uzyskać informacje o godzinach otwarcia danego miejsca.
typedef void(^ GMSPlaceSearchByTextResultCallback )(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error)
 Typ wywołania zwrotnego dla otrzymywania wyników wyszukiwania tekstowego.

Dokumentacja funkcji członka

+ (typ instancji) sharedClient

Udostępnia współdzielone wystąpienie GMSPlacesClient na potrzeby pakietu SDK Miejsc Google na iOS, tworząc w razie potrzeby.

Jeśli Twoja aplikacja często używa metod GMSPlacesClient, może chcieć zatrzymać się bezpośrednio na tym obiekcie. W przeciwnym razie połączenie z Google może być regularnie uruchamiane ponownie.

+ (BOOL) provideAPIKey: (NSString *) klucz

Dostarcza klucz interfejsu API do pakietu SDK Miejsc Google na iOS.

Ten klucz jest generowany dla aplikacji przez konsolę Google Cloud Platform i jest powiązany z identyfikatorem pakietu aplikacji w celu jego identyfikacji. Powinna ona zostać wywołana przez aplikację przed użyciem GMSPlacesClient (np. w aplikacji:didFinishLaunchingWithOptions:).

Zwroty:
TAK, jeśli podano klucz API.
+ (NSString *) openSourceLicenseInfo

Zwraca informacje o licencji open source pakietu SDK Miejsc Google na iOS.

Te informacje należy udostępnić w aplikacji.

+ (NSString *) SDKVersion

Zwraca wersję tej wersji pakietu SDK Miejsc Google na iOS.

. Na przykład „1.0.0”.

+ (NSString *) SDKLongVersion

Zwraca długą wersję tej wersji pakietu SDK Miejsc Google na iOS.

. Na przykład „1.0.0 (102.1)”.

- (void) LookUpPlaceID: (NSString *) placeID
wywołanie zwrotne: (GMSPlaceResultCallback) callback (oddzwonienie)

Pobierz szczegóły miejsca.

Ta metoda nie blokuje blokowania.

Parametry:
placeIDIdentyfikator miejsca do wyszukania.
wywołanie zwrotneWywołanie zwrotne do wywołania z wynikiem wyszukiwania.
- (void) LookUpPhotosForPlaceID: (NSString *) placeID
wywołanie zwrotne: (GMSPlacePhotoMetadataResultCallback) callback (oddzwonienie)

Pobiera metadane maksymalnie 10 zdjęć powiązanych z miejscem.

Zdjęcia pochodzą z różnych lokalizacji, np. od właścicieli firm i od użytkowników Google+. W większości przypadków mogą one zostać wykorzystane bez informacji o ich źródle lub będą zawierać wymagane informacje o ich źródle. Musisz jednak użyć w odpowiedzi właściwości attributions, aby pobrać wszelkie wymagane dodatkowe informacje o źródłach i wyświetlać je w aplikacji zawsze, gdy wyświetlasz obraz. Zwracanych jest maksymalnie 10 zdjęć.

Wielokrotne wywołania tej metody prawdopodobnie spowodują zwrócenie tego samego zdjęcia za każdym razem. Nie jest to jednak gwarantowane, ponieważ dane źródłowe mogły ulec zmianie.

Ta metoda przeprowadza wyszukiwanie sieci.

Parametry:
placeIDIdentyfikator miejsca, którego zdjęcia mają zostać wyszukane.
wywołanie zwrotneWywołanie zwrotne do wywołania z wynikiem wyszukiwania.
- (void) loadPlacePhoto: (GMSPlacePhotoMetadata *) photoMetadata
wywołanie zwrotne: (GMSPlacePhotoImageResultCallback) callback (oddzwonienie)

Powoduje wczytywanie określonego zdjęcia w maksymalnym rozmiarze.

Dane obrazu mogą być przechowywane w pamięci podręcznej przez pakiet SDK. Jeśli żądanego zdjęcia nie ma w pamięci podręcznej, zostanie przeprowadzone wyszukiwanie sieci.

Parametry:
photoMetadataElement GMSPlacePhotoMetadata, dla którego ma zostać wczytany element UIImage.
wywołanie zwrotneWywołanie zwrotne do wywołania z wczytanym elementem UIImage.
- (void) loadPlacePhoto: (GMSPlacePhotoMetadata *) photoMetadata
restrictionToSize: (CGSize) maxSize
skala: (CGFloat) skala
wywołanie zwrotne: (GMSPlacePhotoImageResultCallback) callback (oddzwonienie)

Wczytuje zdjęcie określonego zdjęcia, przeskalowane w celu dopasowania do podanych maksymalnych wymiarów.

Obraz zostanie przeskalowany, by pasował do podanych wymiarów, zachowując proporcje oryginalnego obrazu. Skalowanie jest wykonywane po stronie serwera.

Jeśli parametr skali nie ma wartości 1,0 maxSize, zostanie pomnożony przez tę wartość, a w zwracanym obiekcie UIImage zostanie użyta określona skala. Jeśli wczytujesz obrazy do wyświetlenia na ekranie, ten parametr powinien być ustawiony na skalę ekranu.

Dane obrazu mogą być przechowywane w pamięci podręcznej przez pakiet SDK. Jeśli żądanego zdjęcia nie ma w pamięci podręcznej, zostanie przeprowadzone wyszukiwanie sieci.

Uwaga:
Po zastosowaniu współczynnika skali wymiary podane w parametrze maxSize zostaną zaokrąglone w górę do najbliższej liczby całkowitej przed użyciem. Jeśli zamówiony obraz będzie większy niż maksymalny dostępny rozmiar, może zostać zwrócony mniejszy obraz.
Parametry:
photoMetadataElement GMSPlacePhotoMetadata, dla którego ma zostać wczytany element UIImage.
maxSizeMaksymalny rozmiar obrazu.
skalaSkala wczytywania obrazu.
wywołanie zwrotneWywołanie zwrotne do wywołania z wczytanym elementem UIImage.
– (void) currentPlaceWithCallback: (GMSPlaceLikelihoodListCallback oddzwonienie

Zwraca przybliżone miejsce, w którym obecnie znajduje się urządzenie.

Generuje listę prawdopodobnych miejsc na podstawie ostatniej szacowanej lokalizacji urządzenia. Podane wywołanie zwrotne będzie wywoływane z tą listą prawdopodobieństwa w przypadku powodzenia i NSError w przypadku błędu.

Uwaga:
Ta metoda wymaga, aby aplikacja miała dostęp do bieżącej lokalizacji urządzenia. Zanim wywołasz tę funkcję, poproś o dostęp do lokalizacji użytkownika za pomocą metody [CLLocationManager requestWhenInUseAuthorization] lub [CLLocationManager requestZawszeAuthorization]. Jeśli wywołasz tę metodę, a aplikacja nie będzie miała prawidłowego stanu autoryzacji, wywołanie zwrotne zostanie zrealizowane z błędem.
Parametry:
wywołanie zwrotneWywołanie zwrotne do wywołania z listą prawdopodobieństwa miejsca.
- (void) findAutocompletePredictionsFromQuery: (NSString *) zapytanie
filtr: (wartość null GMSAutocompleteFilter *) filtr
sessionToken: (wartość null GMSAutocompleteSessionToken *) sessionToken
wywołanie zwrotne: (GMSAutocompletePredictionsCallback) callback (oddzwonienie)

Sprawdzanie podpowiedzi autouzupełniania na podstawie zapytań tekstowych.

Wyniki mogą opcjonalnie być stronnicze i dotyczące określonej lokalizacji lub ograniczone do konkretnego obszaru. Ta metoda nie blokuje blokowania.

Podane wywołanie zwrotne jest wywoływane z tablicą prognoz autouzupełniania w przypadku powodzenia, a w przypadku błędu – z błędem.

Parametry:
zapytanieCzęściowy tekst do autouzupełniania.
filterFiltr, który zostanie zastosowany do wyników. Ten parametr może być pusty.
sessionTokenGMSAutocompleteSessionToken do powiązania żądania z sesją rozliczeniową.
wywołanie zwrotneWywołanie zwrotne do wywołania z prognozami.
- (void) fetchPlaceFromPlaceID: (NSString *) placeID
PlaceFields: (GMSPlaceField) placeFields
sessionToken: (wartość null GMSAutocompleteSessionToken *) sessionToken
wywołanie zwrotne: (GMSPlaceResultCallback) callback (oddzwonienie)

Pobierz szczegółowe informacje o miejscu.

Ta metoda nie blokuje blokowania.

Parametry:
placeIDIdentyfikator miejsca do wyszukania.
placeFieldsPoszczególne pola miejsc żądane w przypadku obiektów na liście.
sessionTokenGMSAutocompleteSessionToken do powiązania żądania z sesją rozliczeniową.
wywołanie zwrotneWywołanie zwrotne do wywołania z wynikiem wyszukiwania.
- (void) findPlaceRightlikelihoodsZCurrentLocationWithPlaceFields: (GMSPlaceField) placeFields
wywołanie zwrotne: (GMSPlaceLikelihoodsCallback callback (oddzwonienie)

Określ prawdopodobne miejsce na podstawie bieżącej lokalizacji użytkownika.

Ta metoda nie blokuje blokowania.

Podane wywołanie zwrotne będzie wywoływane z tablicą miejsc z wynikami prawdopodobieństwa w przypadku powodzenia i NSError w przypadku błędu.

Parametry:
placeFieldsPoszczególne pola miejsc żądane w przypadku obiektów na liście.
wywołanie zwrotneWywołanie zwrotne do wywołania z prawdopodobieństwem miejsca.
- (void) Parametr isOpenWithPlaceID: (NSString *) placeID
wywołanie zwrotne: (GMSPlaceOpenStatusCallback) callback (oddzwonienie)

Pobiera informacje o danym miejscu, w tym wszystkie pola niezbędne do określenia obiektu GMSPlaceOpenStatus w bieżącym czasie.

Ta metoda nie blokuje blokowania.

Parametry:
placeIDIdentyfikator miejsca do wyszukania.
wywołanie zwrotneWywołanie zwrotne do wywołania z wynikiem miejsca.
- (void) Parametr isOpenWithPlaceID: (NSString *) placeID
data: (NSDate *) data
wywołanie zwrotne: (GMSPlaceOpenStatusCallback) callback (oddzwonienie)

Pobiera informacje o miejscu, w tym wszystkie pola niezbędne do określenia GMSPlaceOpenStatus w określonym NSDate.

Ta metoda nie blokuje blokowania.

Parametry:
placeIDIdentyfikator miejsca do wyszukania.
datePole NSDate, w którym można określić stan otwarty dla danego miejsca.
wywołanie zwrotneWywołanie zwrotne do wywołania z wynikiem miejsca.
- (void) isOpenWithPlace: (GMSPlace *) miejsce
wywołanie zwrotne: (GMSPlaceOpenStatusCallback) callback (oddzwonienie)

Pobiera informacje o danym miejscu, w tym wszystkie pola niezbędne do określenia obiektu GMSPlaceOpenStatus w bieżącym czasie.

Wysyła żądanie o dodatkowe pola tylko wtedy, gdy GMSPlace nie ma wszystkich wymaganych pól. W przeciwnym razie GMSPlaceOpenStatus zostanie natychmiast zwrócona w wywołaniu zwrotnym. Ta metoda nie blokuje blokowania.

Parametry:
miejscePole GMSPlace do wyszukania.
wywołanie zwrotneWywołanie zwrotne do wywołania z wynikiem miejsca.
- (void) isOpenWithPlace: (GMSPlace *) miejsce
data: (NSDate *) data
wywołanie zwrotne: (GMSPlaceOpenStatusCallback) callback (oddzwonienie)

Pobiera informacje o miejscu, w tym wszystkie pola niezbędne do określenia GMSPlaceOpenStatus w określonym NSDate.

Wysyła żądanie o dodatkowe pola tylko wtedy, gdy GMSPlace nie ma wszystkich wymaganych pól. W przeciwnym razie GMSPlaceOpenStatus zostanie natychmiast zwrócona w wywołaniu zwrotnym. Ta metoda nie blokuje blokowania.

Parametry:
miejscePole GMSPlace do wyszukania.
datePole NSDate, w którym można określić stan otwarty dla danego miejsca.
wywołanie zwrotneWywołanie zwrotne do wywołania z wynikiem miejsca.
- (void) searchByTextWithRequest: (GMSPlaceSearchByTextRequest *) textSearchRequest
wywołanie zwrotne: (GMSPlaceSearchByTextResultCallback) callback (oddzwonienie)

Wyszukuj miejsca według tekstu i ograniczeń.

Ta metoda nie blokuje blokowania.

Parametry:
textSearchRequestGMSPlaceSearchByTextRequest Żądanie tekstowe do użycia w zapytaniu.
wywołanie zwrotneWywołanie zwrotne do wywołania z wynikiem wyszukiwania.
- (typedef void(^ GMSPlaceResultCallback)(GMSPlace *_Nullable result, NSError *_Nullable error)) [related]

Typ wywołania zwrotnego do otrzymywania wyszukiwań szczegółów miejsca.

Jeśli wystąpił błąd, result będzie mieć wartość zerową, a error będzie zawierać informacje o błędzie.

Parametry:
wynikZwrócona wartość GMSPlace.
errorBłąd, który wystąpił (jeśli wystąpił).
- (typedef void(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_Nullable RisingList, NSError *_Nullable error) [related]

Typ wywołania zwrotnego dla otrzymywania list prawdopodobieństwa związanego z miejscem.

Jeśli wystąpił błąd, likelihoodList będzie mieć wartość zerową, a error będzie zawierać informacje o błędzie.

Parametry:
likelihoodListLista prawdopodobieństwu miejsca.
errorBłąd, który wystąpił (jeśli wystąpił).
- (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > *_Nullable Rightss, NSError *_Nullable error)) [related]

Typ wywołania zwrotnego dla tablicy odbierającej o długości GMSPlaceLikelihood s.

Jeśli wystąpił błąd, tablica będzie pusta, a error będzie zawierać informacje o błędzie.

- (typedef void(^ GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error) [related]

Typ wywołania zwrotnego dla otrzymywania wyników autouzupełniania.

results to tablica funkcji GMSAutocompletePredictions, reprezentujących propozycje ukończenia zapytania.

Parametry:
wynikiTablica GMSAutocompletePrediction.
errorBłąd, który wystąpił (jeśli wystąpił).
- (typedef void(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_zdjęcia dopuszczalne, NSError *_błąd nullable)) [related]

Typ wywołania zwrotnego dla wyników wyszukiwania zdjęć miejsc.

Jeśli wystąpił błąd, photos będzie mieć wartość zerową, a error będzie zawierać informacje o błędzie.

Parametry:
fotografieWynik zawierający GMSPlacePhotoMetadata obiektu.
errorBłąd, który wystąpił (jeśli wystąpił).
- (typedef void(^ GMSPlacePhotoImageResultCallback)(UIImage *_Nullable photo, NSError *_Nullable error)) [related]

Typ wywołania zwrotnego do odbierania obiektów UIImage z obiektu GMSPlacePhotoMetadata.

Jeśli wystąpił błąd, photo będzie mieć wartość zerową, a error będzie zawierać informacje o błędzie.

Parametry:
zdjęcieUIImage, który został wczytany.
errorBłąd, który wystąpił (jeśli wystąpił).
- (typedef void(^ GMSPlaceOpenStatusCallback)(wynik GMSPlaceOpenStatus, NSError *_Nullable)) [related]

Typ oddzwaniania, aby uzyskać informacje o godzinach otwarcia danego miejsca.

Jeśli wystąpił błąd, result zmieni się na GMSPlaceOpenStatusUnknown, a error będzie zawierać informacje o błędzie.

Parametry:
wynikZwrócona wartość GMSPlaceOpenStatus.
errorBłąd, który wystąpił (jeśli wystąpił).
- (typedef void(^ GMSPlaceSearchByTextResultCallback)(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error)) [related]

Typ wywołania zwrotnego dla otrzymywania wyników wyszukiwania tekstowego.

results to tablica miejsca GMSPlace reprezentująca poszczególne wyniki pasujące do zapytania.

Parametry:
wynikiTablica GMSPlace.
errorBłąd, który wystąpił (jeśli wystąpił).