Zdjęcia miejsca

Możesz użyć pakietu Places SDK dla iOS, aby poprosić o wyświetlenie zdjęć miejsc Twojej aplikacji. Zdjęcia zwracane przez usługę do zdjęć pochodzą z różnych źródeł takimi jak właściciele firm i zdjęcia przesłane przez użytkowników. Aby pobrać zdjęć danego miejsca, musisz wykonać następujące czynności:

  1. Zadzwoń pod numer [GMSPlacesClient fetchPlaceFromPlaceId]. podając ciąg z identyfikatorem miejsca i wywołaniem zwrotnym. Spowoduje to nawiązanie połączenia zwrotnego z GMSPlacePhotoMetadataList obiektu.
  2. GMSPlacePhotoMetadataList obiekt uzyskuje dostęp do results i wybierz zdjęcia do wczytania z tablicy.
  3. Dla każdej kolumny GMSPlacePhotoMetadata do wczytania z tego wywołania listy [GMSPlacesClient loadPlacePhoto:callback:] lub [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]. Wywołują one funkcję wywołania zwrotnego z użytecznym obiektem UIImage. Zdjęcia mogą mieć maksymalnie szerokość lub wysokość 1600 pikseli.
.

Przykładowy kod

Ta przykładowa metoda rejestruje identyfikator miejsca i pobiera pierwsze zdjęcie w zwrócona lista. Możesz użyć tej metody jako szablonu metody utwórz we własnej aplikacji.

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;
      }
    }];
  }
}];

Pamięć podręczna

Zdjęcia wczytane przy użyciu aplikacji [GMSPlacesClient loadPlacePhoto:callback:] lub [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:] są buforowane zarówno na dysku, jak i w pamięci przez system wczytywania adresu URL Fundation. w udostępnionym NSURLCache.

Aby skonfigurować działanie buforowania, możesz zmienić udostępnianą pamięć podręczną za pomocą polecenia [NSURLCache setSharedURLCache:] w dokumencie application:didFinishLaunchingWithOptions: przedstawiciela aplikacji .

Jeśli nie chcesz, aby Twoja aplikacja udostępniała zasób NSURLCache W Miejscach SDK na iOS można utworzyć nowy obiekt NSURLCache i użyć go tylko w aplikacji, bez ustawiania jej jako współdzielonej pamięci podręcznej.

Atrybucje

W większości przypadków zdjęcia miejsc można wykorzystać bez podawania informacji o autorze. wymagane źródło informacji. Jeśli jednak zostanie zwrócony GMSPlacePhotoMetadata wystąpienia atrybucji, musisz podać dodatkowe źródło bezpośrednio w aplikacji, w której jest wyświetlany obraz. Pamiętaj, że linki w informacje o autorze utworu muszą być klikalne. Zobacz dokumentację na temat atrybucji.

Limity wykorzystania

Pobranie zdjęcia wiąże się z kosztami za 1 jednostkę limitu. nie ma żadnych limitów wykorzystania dla pobierania metadanych zdjęcia. Więcej informacji o użycie i płatności.