Zdjęcia miejsca (nowość) pozwalają dodawać do aplikacji materiały fotograficzne wysokiej jakości. Zdjęcia miejsc zapewniają dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Zdjęcia miejsc zwraca identyfikator URI obrazu bitmapowego. Obraz bitmapowy może mieć maksymalny rozmiar 4800 x 4800 pikseli.
Prośby dotyczące miejsc ze Zdjęć Google
Aby pobrać obraz danego miejsca:
- Użyj opcji Szczegóły miejsca (nowe), aby pobrać obiekt
Place
za pomocąfetchPlace()
. Pamiętaj, aby na liście pól, które mają znajdować się w obiekcie odpowiedziPlace
, uwzględnione jest polePlace.Field PHOTO_METADATAS
. - W polu
OnSuccessListener
komponentuFetchPlaceResponse
wywołajPlace.getPhotoMetadas()
, aby pobrać obiekt metadanych zdjęcia typuPhotoMetadata
z obiektu odpowiedziPlace
. - Utwórz obiekt
FetchResolvedPhotoUriRequest
, aby przesłać żądanie i przekazać obiekt metadanych zdjęcia, a także wartości maksymalnej wysokości i maksymalnej szerokości (albo jedno i drugie). - Użyj
PlacesClient.fetchResolvedPhotoUri()
, aby poprosić o identyfikator URI zdjęcia. - Dodaj
OnSuccessListener
i pobierz identyfikator URI zdjęcia z obiektuFetchResolvedPhotoUriResponse
.
Wymagane parametry
Wymagane parametry parametru FetchResolvedPhotoUriRequest
:
-
Metadane zdjęcia
Obiekt metadanych zdjęcia do zwrócenia.
-
Maksymalna wysokość lub maksymalna szerokość
Określa maksymalną wysokość i szerokość obrazu do zwrócenia (w pikselach). Jeśli obraz będzie mniejszy niż określone wartości, zwrócony zostanie obraz oryginalny. Jeśli obraz jest większy w dowolnym z tych wymiarów, zostanie przeskalowany tak, by dopasować go do mniejszego z tych 2 wymiarów w ograniczeniu do pierwotnego formatu obrazu. Zarówno właściwości maksymalnej wysokości, jak i maksymalnej szerokości akceptują liczby całkowite z zakresu od 1 do 4800. Musisz określić maksymalną wysokość, maksymalną szerokość lub obie te wartości.
- Aby ustawić parametr maksymalnej wysokości, podczas tworzenia obiektu
FetchResolvedPhotoUriRequest
wywołaj metodęsetMaxHeight()
. - Aby ustawić parametr maksymalnej szerokości, podczas tworzenia obiektu
FetchResolvedPhotoUriRequest
wywołaj metodęsetMaxWidth()
.
- Aby ustawić parametr maksymalnej wysokości, podczas tworzenia obiektu
Przykłady zdjęć miejsc
Poniższy przykład pokazuje pobieranie identyfikatora URI zdjęcia miejsca.
// Define a Place ID. final String placeId = "INSERT_PLACE_ID_HERE"; // Specify fields. Requests for photos must always have the PHOTO_METADATAS field. final List<Place.Field> fields = Collections.singletonList(Place.Field.PHOTO_METADATAS); // Get a Place object (this example uses fetchPlace(), but you can also use findCurrentPlace()) final FetchPlaceRequest placeRequest = FetchPlaceRequest.newInstance(placeId, fields); placesClient.fetchPlace(placeRequest).addOnSuccessListener((response) -> { final Place place = response.getPlace(); // Get the photo metadata. final List<PhotoMetadata> metadata = place.getPhotoMetadatas(); if (metadata == null || metadata.isEmpty()) { Log.w(TAG, "No photo metadata."); return; } final PhotoMetadata photoMetadata = metadata.get(0); // Get the attribution text and author attributions. final String attributions = photoMetadata.getAttributions(); final AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions(); // Create a FetchResolvedPhotoUriRequest. final FetchResolvedPhotoUriRequest photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata) .setMaxWidth(500) .setMaxHeight(300) .build(); // Request the photo URI placesClient.fetchResolvedPhotoUri(photoRequest).addOnSuccessListener((fetchResolvedPhotoUriResponse) -> { Uri uri = fetchResolvedPhotoUriResponse.getUri(); RequestOptions requestOptions = new RequestOptions().override(Target.SIZE_ORIGINAL); Glide.with(this).load(uri).apply(requestOptions).into(imageView); }).addOnFailureListener((exception) -> { if (exception instanceof ApiException) { final ApiException apiException = (ApiException) exception; Log.e(TAG, "Place not found: " + exception.getMessage()); final int statusCode = apiException.getStatusCode(); // TODO: Handle error with given status code. } }); });
Atrybucje
W większości przypadków zdjęcia miejsc mogą być wykorzystane bez podawania informacji o autorze lub zawierać wymagane informacje o autorze jako część zdjęcia. Obiekt metadanych zdjęcia typu PhotoMetadata
może jednak zawierać jeden z 2 dodatkowych informacji o źródłach:
- Attributions (Atrybucja) – ciąg tekstowy atrybucji, do którego dostęp ma użytkownik
PhotoMetadata.getAttributions()
. - AuthorAttributions – obiekt
AuthorAttributions
, do którego dostęp maPhotoMetadata.getAuthorAttributions()
.
Jeśli zwrócony obiekt PhotoMetadata
zawiera dowolny typ atrybucji, musisz uwzględnić ten model w aplikacji w każdym miejscu, w którym wyświetlasz obraz. Więcej informacji znajdziesz w sekcji Wyświetlanie atrybucji.