Możesz użyć pakietu Places SDK dla Androida, aby zażądać zdjęcia miejsca, które ma być wyświetlane w Twojej aplikacji. Zdjęcia zwracane przez usługę fotograficzną pochodzą z różnych źródeł, w tym od właścicieli firm i zdjęć przesłanych przez użytkowników.
Wybierz format zdjęcia
Pakiet SDK Miejsc na Androida obsługuje 2 formaty żądanego zdjęcia:
- Wszystkie wersje pakietu Places SDK dla Androida: zwraca obraz bitmapy. Obraz bitmapy ma maksymalny rozmiar 1600 x 1600 pikseli.
- Pakiet SDK Miejsc na Androida w wersji 3.4 i nowszych: zwraca identyfikator URI obrazu bitmapy. Obraz bitmapy ma maksymalny rozmiar 4800 x 4800 pikseli.
Pobieranie zdjęć
Aby pobrać zdjęcie miejsca:
- Użyj szczegółów miejsca, aby pobrać obiekt
Place
(użyjfetchPlace()
lubfindCurrentPlace()
). Pamiętaj, aby na liście pól dodać polePlace.Field PHOTO_METADATAS
do obiektuPlace
w odpowiedzi. - W sekcji
OnSuccessListener
:FetchPlaceResponse
lubFindCurrentPlaceResponse
:- Użyj
Place.getPhotoMetadas()
, aby pobrać obiekt metadanych zdjęcia typuPhotoMetadata
z obiektuPlace
w odpowiedzi. - Aby pobrać obraz bitmapy:
- Utwórz obiekt
FetchPhotoRequest
, opcjonalnie określ maksymalną wysokość i szerokość (w pikselach). Maksymalna szerokość lub wysokość zdjęcia to 1600 pikseli. - Aby poprosić o bitmapę ze zdjęciem, użyj polecenia
PlacesClient.fetchPhoto()
. - Dodaj
OnSuccessListener
i pobierz zdjęcie zFetchPhotoResponse
.
- Utwórz obiekt
- Aby uzyskać identyfikator URI zdjęcia:
- Aby wysłać żądanie, utwórz obiekt
FetchResolvedPhotoUriRequest
. Maksymalna szerokość lub wysokość zdjęć to 4800 pikseli. - Użyj żądania
PlacesClient.fetchResolvedPhotoUri()
, aby zażądać identyfikatora URI zdjęcia. - Dodaj
OnSuccessListener
i uzyskaj identyfikator URI zdjęcia z obiektuFetchResolvedPhotoUriResponse
.
- Aby wysłać żądanie, utwórz obiekt
- Użyj
Dostęp do danych PhotoMetadata dodanych w wersji 3.3.0 i nowszych
Pakiet SDK Miejsc na Androida (nowy) dodaje pole AuthorAttributions
do klasy PhotoMetadata
. Jeśli Twoja aplikacja korzysta z nowego pakietu SDK, obiekt PhotoMetadata
zwracany przez Place.getPhotoMetadas()
może zawierać co najmniej 1 atrybucję autora.
Gdy obiekt PhotoMetadata
zawiera informacje o autorze – zarówno te dodane w wersji 3.3.0, jak i dotychczasowe dostępne w wersji 3.2.0 lub wcześniejszych, musisz je pokazać razem ze zdjęciem. Więcej informacji o obsłudze wszystkich typów atrybucji znajdziesz w artykule Atrybucja.
Aby wypełnić obiekt PhotoMetadata
informacjami o autorze, musisz:
- Włącz nowy pakiet SDK podczas konfigurowania projektu Google Cloud.
- Zainicjuj nowy pakiet SDK w aktywności lub fragmencie.
- Na liście pól w prośbie o szczegóły miejsca dodaj
Place.Field.PHOTO_METADATAS
. - Wywołaj
PlacesClient.fetchPlace()
, aby uzyskać obiektPlace
, iPlace.getPhotoMetadas()
, aby uzyskać obiektPhotoMetadata
. Pole z informacjami o autorze nie jest obsługiwane przezPlacesClient.findCurrentPlace()
. - Aby uzyskać informacje o autorze, użyj narzędzia
PhotoMetadata.getAuthorAttributions()
.
Zrób zdjęcie
W tej sekcji opisano, jak pobrać zdjęcie w postaci bitmapy lub identyfikatora URI.
Pobierz zdjęcie miejsca jako bitmapę
Poniższy przykład pokazuje pobieranie zdjęcia miejsca w postaci bitmapy.
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. } }); });
Pobieranie identyfikatora URI zdjęcia miejsca
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. final String attributions = photoMetadata.getAttributions(); // Create a FetchResolvedPhotoUriRequest. final FetchResolvedPhotoUriRequest photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata) .setMaxWidth(500) // Optional. .setMaxHeight(300) // Optional. .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 można użyć zdjęć miejsc bez informacji o ich źródle lub dodać do nich wymagane informacje o autorze. Jednak obiekt metadanych zdjęcia typu PhotoMetadata
może zawierać jeden z 2 rodzajów dodatkowych informacji o atrybucji:
- Atrybucja: ciąg znaków atrybucji, do którego dostęp ma
PhotoMetadata.getAttributions()
. - AuthorAttributions – obiekt
AuthorAttributions
, do którego dostęp uzyskujePhotoMetadata.getAuthorAttributions()
.
Jeśli zwrócony obiekt PhotoMetadata
zawiera dowolny z tych typów atrybucji, musisz je podać w swojej aplikacji we wszystkich miejscach, w których jest wyświetlana grafika. Więcej informacji znajdziesz w artykule Wyświetlanie atrybucji.
Korzystanie z usługi i płatności
W przypadku połączeń z numerem SKU Places Photo pobierana jest opłata za połączenia z: fetchPhoto()
.
Więcej informacji znajdziesz na stronie Korzystanie i płatności.