Uygulamanızda görüntülenecek bir yer fotoğrafı istemek için Android için Yerler SDK'sını kullanabilirsiniz. Fotoğraf hizmeti tarafından döndürülen fotoğraflar, işletme sahipleri ve kullanıcıların katkıda bulunduğu fotoğraflar da dahil olmak üzere çeşitli kaynaklardan gelir.
Android için Yerler SDK'sı maksimum 1600 x 1600 piksel boyutunda bir bit eşlem görüntüsü döndürür.
Fotoğraf alma işlemi
Bir yere ait resim almak için:
- Bir
Place
nesnesini getirmek için Yer Ayrıntıları'nı kullanın (fetchPlace()
veyafindCurrentPlace()
kullanın). YanıtPlace
nesnesine dahil edilecek alanlar listesinePlace.Field PHOTO_METADATAS
alanını eklediğinizden emin olun. FetchPlaceResponse
veyaFindCurrentPlaceResponse
öğenizinOnSuccessListener
bölümünde, yanıtPlace
nesnesindenPhotoMetadata
türündeki fotoğraf meta veri nesnesini almak içinPlace.getPhotoMetadas()
öğesini kullanın.- İsteğe bağlı olarak maksimum yükseklik ve genişliği (piksel cinsinden) belirterek bir
FetchPhotoRequest
nesnesi oluşturun. Fotoğrafların genişliği veya yüksekliği maksimum 1.600 piksel olabilir. - Fotoğraf bit eşlemi istemek için
PlacesClient.fetchPhoto()
öğesini kullanın. OnSuccessListener
ekleyin ve fotoğrafıFetchPhotoResponse
kaynağından alın.
Fotoğraf al
Aşağıdaki örnekte bir yer fotoğrafının nasıl alınacağı gösterilmektedir:
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. } }); });
İlişkilendirmeler
Çoğu durumda, yer fotoğrafları atıf yapılmadan kullanılabilir veya gerekli atıf resmin bir parçası olarak eklenir. Ancak PhotoMetadata
türündeki fotoğraf meta veri nesnesi, iki tür ek ilişkilendirmeden birini içerebilir:
PhotoMetadata.getAttributions()
tarafından erişilen bir ilişkilendirme dizesi olan İlişkilendirmeler.- AuthorAttributions,
PhotoMetadata.getAuthorAttributions()
tarafından erişilen birAuthorAttributions
nesnesidir.
Döndürülen PhotoMetadata
nesnesi, iki türden bir atıf içeriyorsa ilişkilendirmeyi, görüntüyü görüntülediğiniz her yerde uygulamanıza eklemeniz gerekir. Daha fazla bilgi için İlişkilendirmeleri Görüntüleme konusuna bakın.
Kullanım ve faturalandırma
fetchPhoto()
numaralı telefona yapılan aramalar için Yer Fotoğrafı SKU'su ücretlendirilir.
Ayrıntılar için Kullanım ve Faturalandırma sayfasına göz atın.