Mit dem Places SDK for iOS können Sie Ortsfotos anfordern, die in Ihrer App angezeigt werden. Vom Fotodienst zurückgegebene Fotos stammen aus unterschiedlichen Quellen, z. B. aus Fotos von Geschäftsinhabern und von Nutzern. So rufen Sie Fotos für einen Ort ab:
- Rufen Sie
[GMSPlacesClient fetchPlaceFromPlaceId]
auf und übergeben Sie einen String mit einer Orts-ID und einem Callback. Dadurch wird der Callback mit einemGMSPlacePhotoMetadataList
-Objekt aufgerufen. - Rufen Sie das Objekt
GMSPlacePhotoMetadataList
auf die Propertyresults
auf und wählen Sie die Fotos aus, die aus dem Array geladen werden sollen. - Rufen Sie für jedes
GMSPlacePhotoMetadata
, das aus dieser Liste geladen werden soll,[GMSPlacesClient loadPlacePhoto:callback:]
oder[GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]
auf. Damit wird der Callback mit einem verwendbaren UIImage aufgerufen. Die Breite oder Höhe von Fotos darf maximal 1.600 Pixel betragen.
Beispielcode
Bei der folgenden Beispielmethode wird eine Orts-ID verwendet und das erste Foto aus der zurückgegebenen Liste abgerufen. Sie können diese Methode als Vorlage für die Methode verwenden, die Sie in Ihrer eigenen Anwendung erstellen werden.
Swift
// Specify the place data types to return (in this case, just photos). let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.photos.rawValue))! placesClient?.fetchPlace(fromPlaceID: "INSERT_PLACE_ID_HERE", placeFields: fields, sessionToken: nil, callback: { (place: GMSPlace?, error: Error?) in if let error = error { print("An error occurred: \(error.localizedDescription)") return } if let place = place { // Get the metadata for the first photo in the place photo metadata list. let photoMetadata: GMSPlacePhotoMetadata = place.photos![0] // Call loadPlacePhoto to display the bitmap and attribution. self.placesClient?.loadPlacePhoto(photoMetadata, callback: { (photo, error) -> Void in if let error = error { // TODO: Handle the error. print("Error loading photo metadata: \(error.localizedDescription)") return } else { // Display the first image and its attributions. self.imageView?.image = photo; self.lblText?.attributedText = photoMetadata.attributions; } }) } })
Objective-C
// Specify the place data types to return (in this case, just photos). GMSPlaceField fields = (GMSPlaceFieldPhotos); NSString *placeId = @"INSERT_PLACE_ID_HERE"; [_placesClient fetchPlaceFromPlaceID:placeId placeFields:fields sessionToken:nil callback:^(GMSPlace * _Nullable place, NSError * _Nullable error) { if (error != nil) { NSLog(@"An error occurred %@", [error localizedDescription]); return; } if (place != nil) { GMSPlacePhotoMetadata *photoMetadata = [place photos][0]; [self->_placesClient loadPlacePhoto:photoMetadata callback:^(UIImage * _Nullable photo, NSError * _Nullable error) { if (error != nil) { NSLog(@"Error loading photo metadata: %@", [error localizedDescription]); return; } else { // Display the first image and its attributions. self->imageView.image = photo; self->lblText.attributedText = photoMetadata.attributions; } }]; } }];
Caching
Mit [GMSPlacesClient loadPlacePhoto:callback:]
oder [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]
geladene Fotos werden vom Ladesystem für Fundament-URLs in der freigegebenen NSURLCache
sowohl auf der Festplatte als auch im Arbeitsspeicher im Cache gespeichert.
Zum Konfigurieren des Caching-Verhaltens können Sie den Cache der freigegebenen URL mit [NSURLCache setSharedURLCache:]
in der Methode application:didFinishLaunchingWithOptions:
Ihres Anwendungsdelegats ändern.
Wenn Sie nicht möchten, dass Ihre App eine NSURLCache
mit dem Places SDK for iOS teilt, können Sie eine neue NSURLCache
erstellen und sie ausschließlich in Ihrer App verwenden, ohne sie als gemeinsamen Cache festzulegen.
Attribution
In den meisten Fällen dürfen Ortsfotos ohne Quellenangabe verwendet werden oder die erforderlichen Quellenangaben sind Teil des Bildes. Wenn die zurückgegebene GMSPlacePhotoMetadata
-Instanz jedoch eine Quellenangabe enthält, müssen Sie diese überall dort einfügen, wo das Bild angezeigt wird. Die Links in der Attribution müssen antippbar sein. Weitere Informationen finden Sie in der Dokumentation zu Quellenangaben.
Nutzungslimits
Das Abrufen eines Bildes kostet eine Kontingenteinheit. Es gibt keine Nutzungslimits für das Abrufen von Fotometadaten. Weitere Informationen zu Nutzung und Abrechnung