Übersicht

Hauptschnittstelle zum Places SDK.

Wird für die Suche nach Informationen zu Orten verwendet. Auf diese Klasse sollte über die Methode [GMSPlacesClient sharedClient] zugegriffen werden.

GMSPlacesClient-Methoden sollten nur aus dem Hauptthread aufgerufen werden. Der Aufruf dieser Methoden aus einem anderen Thread führt zu einer Ausnahme oder zu einem nicht definierten Verhalten. Sofern nicht anders angegeben, werden alle Callbacks für den Haupt-Thread aufgerufen.

Funktionen für öffentliche Mitglieder
(ungültig)	– lookUpPlaceID:callback:
	Details zu einem Ort abrufen
(ungültig)	– lookUpPhotosForPlaceID:Callback:
	Ruft die Metadaten für bis zu 10 Fotos eines Ortes ab
(ungültig)	– loadPlacePhoto:callback:
	Lädt das Bild für ein bestimmtes Foto in maximaler Größe.
(ungültig)	– loadPlacePhoto:restrictedToSize:scale:callback:
	Lädt das Bild für ein bestimmtes Foto, das an die angegebenen maximalen Abmessungen angepasst wurde
(ungültig)	– currentPlaceWithCallback:
	Gibt eine Schätzung des Ortes zurück, an dem sich das Gerät derzeit befindet.
(ungültig)	– findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
	Hier werden automatisch vervollständigte Suchanfragen in der Textabfrage angezeigt.
(ungültig)	– fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
	Details zu einem Ort abrufen
(ungültig)	– findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
	Wahrscheinlichkeiten für den Ort anhand des aktuellen Standorts des Nutzers ermitteln.
Statische öffentliche Mitgliederfunktionen
(instancetype)	+ sharedClient
	Stellt die freigegebene Instanz von GMSPlacesClient für das Google Places SDK for iOS bereit und erstellt sie bei Bedarf.
(BOOL)	+ ProvideAPIKey:
	Stellt Ihren API-Schlüssel für das Google Places SDK for iOS bereit.
(NSString *)	+ openSourceLicenseInfo
	Gibt die Open-Source-Softwarelizenzinformationen für das Google Places SDK for iOS zurück.
(NSString *)	+ SDKVersion
	Gibt die Version für diesen Release des Google Places SDK for iOS zurück.
(NSString *)	+ SDKLongVersion
	Gibt die lange Version für diese Version des Google Places SDK for iOS zurück.
Zugehörige Funktionen
(Hinweis: Dies sind keine Mitgliederfunktionen.)
typedef void(^	GMSPlaceResultCallback )(GMSPlace _Nullable result, NSError _Nullable error)
	Callback-Typ für die Suche nach Ortsdetails.
typedef void(^	GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList _Nullable WahrscheinlichList, NSError _Nullable-Fehler)
	Callback-Typ zum Empfangen von Ortswahrscheinlichkeitslisten
typedef void(^	GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > _Nullable Wahrscheinlichkeiten, NSError _Nullable-Fehler)
	Callback-Typ zum Empfangen des Arrays von `GMSPlaceLikelihood`s.
typedef void(^	GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > _Nullable Ergebnisse, NSError _Nullable-Fehler)
	Callback-Typ zum Empfangen von Ergebnissen der automatischen Vervollständigung.
typedef void(^	GMSPlacePhotoMetadataResultCallback )(GMSPlacePhotoMetadataList _Nullable photos, NSError _Nullable error)
	Callback-Typ zum Empfangen von Ergebnissen von Ortsfotos.
typedef void(^	GMSPlacePhotoImageResultCallback))(UIImage _Nullable photo, NSError _Nullable error)
	Callback-Typ zum Empfangen von `UIImage`-Objekten von einem `GMSPlacePhotoMetadata`-Objekt.

Dokumentation zu Mitgliederfunktionen

+ (Instanztyp) sharedClient

Stellt die freigegebene Instanz von GMSPlacesClient für das Google Places SDK for iOS bereit und erstellt sie bei Bedarf.

Wenn in Ihrer App häufig Methoden für GMSPlacesClient verwendet werden, kann es sinnvoll sein, dieses Objekt direkt beizubehalten, da Ihre Verbindung zu Google möglicherweise regelmäßig neu gestartet wird.

+ (BOOL) ProvideAPIKey: (NSString *) key

Stellt Ihren API-Schlüssel für das Google Places SDK for iOS bereit.

Dieser Schlüssel wird über die Google Cloud Platform Console für Ihre Anwendung generiert und mit der Bundle-ID Ihrer Anwendung gekoppelt, um ihn zu identifizieren. Dieser sollte von Ihrer Anwendung aufgerufen werden, bevor Sie GMSPlacesClient verwenden (z.B. in „application:didFinishLaunchingWithOptions:“).

Gibt zurück:: JA, wenn der API-Schlüssel erfolgreich angegeben wurde.

+ (NSString *) openSourceLicenseInfo

Gibt die Open-Source-Softwarelizenzinformationen für das Google Places SDK for iOS zurück.

Diese Informationen müssen in Ihrer App verfügbar gemacht werden.

+ (NSString *) SDKVersion

Gibt die Version für diesen Release des Google Places SDK for iOS zurück.

. Beispiel: „1.0.0“.

+ (NSString *) SDKLongVersion

Gibt die lange Version für diese Version des Google Places SDK for iOS zurück.

. Beispiel: „1.0.0 (102.1)“.

– (void)lookUpPlaceID:	(NSString *)	Orts-ID
Callback:	(GMSPlaceResultCallback)	Callback

Details zu einem Ort abrufen

Diese Methode hat keine Blockierung.

Parameter:

PlaceID	Die Orts-ID für die Suche
callback	Der Callback, der mit dem Suchergebnis aufgerufen wird.

– (void) viewUpPhotosForPlaceID:	(NSString *)	Orts-ID
Callback:	(GMSPlacePhotoMetadataResultCallback)	Callback

Ruft die Metadaten für bis zu 10 Fotos eines Ortes ab

Die Fotos stammen aus unterschiedlichen Quellen, darunter Geschäftsinhaber und Fotos, die von Google+ Nutzern gepostet wurden. In den meisten Fällen können diese Fotos ohne Quellenangabe verwendet werden bzw. sind die erforderlichen Zuordnungen bereits im Bild eingebunden. Du musst jedoch die attributions-Property in der Antwort verwenden, um alle erforderlichen Zuordnungen abzurufen und in deiner Anwendung anzuzeigen, wo immer du das Bild anzeigen kannst. Es werden maximal 10 Fotos zurückgegeben.

Bei mehreren Aufrufen dieser Methode werden wahrscheinlich jedes Mal dieselben Fotos zurückgegeben. Dies ist jedoch nicht garantiert, weil sich die zugrunde liegenden Daten möglicherweise geändert haben.

Diese Methode führt eine Netzwerksuche aus.

Parameter:

PlaceID	Die Orts-ID, nach der Fotos gesucht werden sollen.
callback	Der Callback, der mit dem Suchergebnis aufgerufen wird.

- (void) loadPlacePhoto:	(GMSPlacePhotoMetadata *)	photoMetadata
Callback:	(GMSPlacePhotoImageResultCallback)	Callback

Lädt das Bild für ein bestimmtes Foto in maximaler Größe.

Bilddaten können vom SDK im Cache gespeichert werden. Wenn das angeforderte Foto nicht im Cache vorhanden ist, wird eine Netzwerksuche durchgeführt.

Parameter:

bildmetadaten	Die `GMSPlacePhotoMetadata`, für die eine `UIImage` geladen werden soll.
callback	Der Callback, der mit dem geladenen `UIImage` aufgerufen wird.

- (void) loadPlacePhoto:	(GMSPlacePhotoMetadata *)	photoMetadata
restrictedToSize:	(CGGröße)	maxSize
Skalierung:	(CGFloat)	Skala
Callback:	(GMSPlacePhotoImageResultCallback)	Callback

Lädt das Bild für ein bestimmtes Foto, das an die angegebenen maximalen Abmessungen angepasst wurde

Das Bild wird so skaliert, dass es in die vorgegebenen Abmessungen passt, dabei aber das Seitenverhältnis des ursprünglichen Bilds beibehalten wird. Diese Skalierung erfolgt serverseitig.

Wenn der Skalierungsparameter nicht 1,0 ist, wird der maxSize-Wert mit diesem Wert multipliziert und das zurückgegebene UIImage wird auf den angegebenen Wert eingestellt. Dieser Parameter sollte auf die Bildschirmskalierung festgelegt werden, wenn Sie Bilder für die Anzeige auf dem Bildschirm laden.

Bilddaten können vom SDK im Cache gespeichert werden. Wenn das angeforderte Foto nicht im Cache vorhanden ist, wird eine Netzwerksuche durchgeführt.

Hinweis:: Nach Anwendung des Skalierungsfaktors werden die Dimensionen in „maxSize“ vor der Verwendung auf die nächste Ganzzahl aufgerundet. Wenn ein Bild angefordert wird, das die zulässige Größe überschreitet, kann ein kleineres Bild zurückgegeben werden.

Parameter:

bildmetadaten	Die `GMSPlacePhotoMetadata`, für die eine `UIImage` geladen werden soll.
MaxSize	Die maximale Größe des Bildes.
profitieren	Die Waage, mit der das Bild geladen wird.
callback	Der Callback, der mit dem geladenen `UIImage` aufgerufen wird.

– (void) currentPlaceWithCallback: (GMSPlaceLikelihoodListCallback) callback

Gibt eine Schätzung des Ortes zurück, an dem sich das Gerät derzeit befindet.

Erstellt eine Ortswahrscheinlichkeitsliste auf Grundlage des letzten geschätzten Standorts des Geräts. Der bereitgestellte Callback wird mit dieser Wahrscheinlichkeitsliste (Erfolg) und einem NSError (Fehler) ausgelöst.

Hinweis:: Diese Methode erfordert, dass deine App die Berechtigung hat, auf den aktuellen Gerätestandort zuzugreifen. Bevor Sie dies aufrufen, müssen Sie den Zugriff auf den Standort von Nutzern mithilfe von [CLLocationManager requestWennInUseAutorisierung] oder [CLLocationManager requestAlwaysAutorisierung] anfordern. Wenn Sie diese Methode aufrufen und Ihre App nicht über den korrekten Autorisierungsstatus verfügt, wird der Callback mit einer Fehlermeldung aufgerufen.

Parameter:

callback Der Callback, der mit der Liste zur Ortswahrscheinlichkeit aufgerufen wird.

– (void) findAutocompletePredictionsFromQuery:	(NSString *)	query
Filter:	(für GMSAutocompleteFilter * zulässig)	Filter
sessionToken:	(für GMSAutocompleteSessionToken* zulässig)	sessionToken
Callback:	(GMSAutocompletePredictionsCallback)	Callback

Hier werden automatisch vervollständigte Suchanfragen in der Textabfrage angezeigt.

Die Ergebnisse können optional auf einen bestimmten Standort ausgerichtet oder auf einen bestimmten Bereich beschränkt sein. Diese Methode hat keine Blockierung.

Der angegebene Callback wird mit einem Array von automatischen Vervollständigungen bei Erfolg und einem NSError bei einem Fehler aufgerufen.

Parameter:

Abfrage	Der Teiltext, der automatisch vervollständigt werden soll.
Filter	Der Filter, der auf die Ergebnisse angewendet werden soll. Dieser Parameter kann null sein.
Sitzungstoken	Die `GMSAutocompleteSessionToken`, die die Anfrage mit einer Abrechnungssitzung verknüpft werden soll.
callback	Der Callback, der mit den Vorhersagen aufgerufen wird.

– (void)fetchPlaceFromPlaceID:	(NSString *)	Orts-ID
PlaceFelder:	(GMSPlaceField)	placeFelder
sessionToken:	(für GMSAutocompleteSessionToken* zulässig)	sessionToken
Callback:	(GMSPlaceResultCallback)	Callback

Details zu einem Ort abrufen

Diese Methode hat keine Blockierung.

Parameter:

PlaceID	Die Orts-ID für die Suche
Logo: PlaceFields	Die einzelnen Ortsfelder, die für die Ortsobjekte in der Liste angefordert werden
Sitzungstoken	Die `GMSAutocompleteSessionToken`, die die Anfrage mit einer Abrechnungssitzung verknüpft werden soll.
callback	Der Callback, der mit dem Suchergebnis aufgerufen wird.

- (void) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:	(GMSPlaceField)	placeFelder
Callback:	(GMSPlaceLikelihoodsCallback)	Callback

Wahrscheinlichkeiten für den Ort anhand des aktuellen Standorts des Nutzers ermitteln.

Diese Methode hat keine Blockierung.

Der angegebene Callback wird mit einem Array von Orten mit Wahrscheinlichkeitsquoten bei Erfolg und einem NSError bei einem Fehler aufgerufen.

Parameter:

Logo: PlaceFields	Die einzelnen Ortsfelder, die für die Ortsobjekte in der Liste angefordert werden
callback	Der Callback, der mit Ortswahrscheinlichkeiten aufgerufen wird.

– (typedef void(^ GMSPlaceResultCallback)(GMSPlace *_Nullable result, NSError *_Nullable error)) [related]

Callback-Typ für die Suche nach Ortsdetails.

Wenn ein Fehler aufgetreten ist, ist result null und error enthält Informationen zum Fehler.

Parameter:

Ergebnis	`GMSPlace`, die zurückgegeben wurde.
error	Der aufgetretene Fehler, falls vorhanden.

– (typedef void(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_NullableabilityList, NSError *_Nullable error)) [related]

Callback-Typ zum Empfangen von Ortswahrscheinlichkeitslisten

Wenn ein Fehler aufgetreten ist, ist likelihoodList null und error enthält Informationen zum Fehler.

Parameter:

Wahrscheinlichkeitsliste	Die Liste der Wahrscheinlichkeiten für einen Ort.
error	Der aufgetretene Fehler, falls vorhanden.

– (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > *_Nullable Wahrscheinlichkeiten, NSError *_Nullable error)) [related]

Callback-Typ zum Empfangen des Arrays von GMSPlaceLikelihoods.

Wenn ein Fehler aufgetreten ist, ist das Array null und error enthält Informationen zum Fehler.

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

Callback-Typ zum Empfangen von Ergebnissen der automatischen Vervollständigung.

results ist ein Array von GMSAutocompletePredictions, die die möglichen Vervollständigungen der Abfrage darstellen.

Parameter:

Ergebnisse	Ein Array mit `GMSAutocompletePrediction`-Werten.
error	Der aufgetretene Fehler, falls vorhanden.

– (typedef void(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Nullable photos, NSError *_Nullable error)) [related]

Callback-Typ zum Empfangen von Ergebnissen von Ortsfotos.

Wenn ein Fehler aufgetreten ist, ist photos null und error enthält Informationen zum Fehler.

Parameter:

fotos	Das Ergebnis, das `GMSPlacePhotoMetadata`-Objekte enthält.
error	Der aufgetretene Fehler, falls vorhanden.

– (typedef void(^ GMSPlacePhotoImageResultCallback)(UIImage *_Nullable photo, NSError *_Nullable error)) [related]

Callback-Typ zum Empfangen von UIImage-Objekten von einem GMSPlacePhotoMetadata-Objekt.

Wenn ein Fehler aufgetreten ist, ist photo null und error enthält Informationen zum Fehler.

Parameter:

foto	`UIImage` wurde geladen.
error	Der aufgetretene Fehler, falls vorhanden.

GMSPlacesClient-Klassenreferenz

Übersicht

Funktionen für öffentliche Mitglieder

Statische öffentliche Mitgliederfunktionen

Zugehörige Funktionen

Dokumentation zu Mitgliederfunktionen

Dokumentation zu Friends und verwandten Funktionen