Za pomocą pakietu Places SDK dla Androida można poprosić o zdjęcie miejsca do wyświetlenia w aplikacji. Zdjęcia zwracane w usłudze zdjęć pochodzą z różnych źródeł, m.in. od właścicieli firm i użytkowników.
Pakiet Places SDK na Androida zwraca obraz bitmapowy o maksymalnym rozmiarze 1600 x 1600 pikseli.
Proces pobierania zdjęć
Aby pobrać obraz danego miejsca:
- Użyj opcji Szczegóły miejsca, aby pobrać obiekt
Place
(użyjfetchPlace()
lubfindCurrentPlace()
). Pamiętaj, aby uwzględnić polePlace.Field PHOTO_METADATAS
na liście pól, które mają zostać uwzględnione w obiekciePlace
odpowiedzi. - W polu
OnSuccessListener
dla klasyFetchPlaceResponse
lubFindCurrentPlaceResponse
użyjPlace.getPhotoMetadas()
, aby pobrać obiekt metadanych zdjęcia typuPhotoMetadata
z obiektu odpowiedziPlace
. - Utwórz obiekt
FetchPhotoRequest
, opcjonalnie określając maksymalną wysokość i szerokość (w pikselach). Maksymalna szerokość lub wysokość zdjęć to 1600 pikseli. - Użyj zapytania
PlacesClient.fetchPhoto()
, aby poprosić o mapę bitową zdjęcia. - Dodaj
OnSuccessListener
i pobierz zdjęcie z:FetchPhotoResponse
.
Zrób zdjęcie
Ten przykład pokazuje, jak pobrać zdjęcie miejsca:
Kotlin
// Define a Place ID. val placeId = "INSERT_PLACE_ID_HERE" // Specify fields. Requests for photos must always have the PHOTO_METADATAS field. val fields = listOf(Place.Field.PHOTO_METADATAS) // Get a Place object (this example uses fetchPlace(), but you can also use findCurrentPlace()) val placeRequest = FetchPlaceRequest.newInstance(placeId, fields) placesClient.fetchPlace(placeRequest) .addOnSuccessListener { response: FetchPlaceResponse -> val place = response.place // Get the photo metadata. val metada = place.photoMetadatas if (metada == null || metada.isEmpty()) { Log.w(TAG, "No photo metadata.") return@addOnSuccessListener } val photoMetadata = metada.first() // Get the attribution text. val attributions = photoMetadata?.attributions // Create a FetchPhotoRequest. val photoRequest = FetchPhotoRequest.builder(photoMetadata) .setMaxWidth(500) // Optional. .setMaxHeight(300) // Optional. .build() placesClient.fetchPhoto(photoRequest) .addOnSuccessListener { fetchPhotoResponse: FetchPhotoResponse -> val bitmap = fetchPhotoResponse.bitmap imageView.setImageBitmap(bitmap) }.addOnFailureListener { exception: Exception -> if (exception is ApiException) { Log.e(TAG, "Place not found: " + exception.message) val statusCode = exception.statusCode TODO("Handle error with given status code.") } } }
Java
// 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. final String attributions = photoMetadata.getAttributions(); // Create a FetchPhotoRequest. final FetchPhotoRequest photoRequest = FetchPhotoRequest.builder(photoMetadata) .setMaxWidth(500) // Optional. .setMaxHeight(300) // Optional. .build(); placesClient.fetchPhoto(photoRequest).addOnSuccessListener((fetchPhotoResponse) -> { Bitmap bitmap = fetchPhotoResponse.getBitmap(); imageView.setImageBitmap(bitmap); }).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.
Korzystanie i płatności
Za połączenia z numerem fetchPhoto()
naliczana jest opłata za zdjęcie w Miejscach.
Więcej informacji znajdziesz na stronie Użycie i płatności.