Uygulamanızda görüntülenecek bir yer fotoğrafı isteğinde bulunmak 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.
Fotoğraf biçimini seçin
Android için Yerler SDK'sı, istenen fotoğraf için iki biçimi destekler:
- Android sürümleri için Tüm Yerler SDK'sı: Bit eşlem görüntüsünü döndürür. Bit eşlem resminin boyutu maksimum 1.600x1.600 pikseldir.
- Android (Yeni) sürüm 3.4 ve üzeri için Yerler SDK'sı: Bit eşlem görüntüsüne bir URI döndürür. Bit eşlem resminin boyutu maksimum 4800x4800 pikseldir.
Fotoğraf alma işlemi
Bir yer için resim almak üzere:
- Bir
Place
nesnesini getirmek için Yer Ayrıntıları'nı kullanın (fetchPlace()
veyafindCurrentPlace()
kullanın).Place.Field PHOTO_METADATAS
alanını, yanıtPlace
nesnesine dahil edilecek alanlar listesine eklediğinizden emin olun. FetchPlaceResponse
veyaFindCurrentPlaceResponse
içinOnSuccessListener
'nda:- Yanıt
Place
nesnesindenPhotoMetadata
türündeki fotoğraf meta veri nesnesini almak içinPlace.getPhotoMetadas()
kullanın. - Bit eşlem resmi almak için:
- İsteğe bağlı olarak maksimum yükseklik ve genişliği (piksel cinsinden) belirterek bir
FetchPhotoRequest
nesnesi oluşturun. Fotoğraflar en fazla 1.600 piksel genişliğe veya yüksekliğe sahip olabilir. - Fotoğraf bit eşlemi istemek için
PlacesClient.fetchPhoto()
aracını kullanın. OnSuccessListener
ekleyin veFetchPhotoResponse
konumundan fotoğraf alın.
- İsteğe bağlı olarak maksimum yükseklik ve genişliği (piksel cinsinden) belirterek bir
- Fotoğraf URI'si almak için:
- İstekte bulunmak için bir
FetchResolvedPhotoUriRequest
nesnesi oluşturun. Fotoğraflar en fazla 4.800 piksel genişliğe veya yüksekliğe sahip olabilir. - Fotoğraf URI'sini istemek için
PlacesClient.fetchResolvedPhotoUri()
öğesini kullanın. - Bir
OnSuccessListener
ekleyin veFetchResolvedPhotoUriResponse
nesnesinden fotoğraf URI'sini alın.
- İstekte bulunmak için bir
- Yanıt
3.3.0 ve sonraki sürümlerde eklenen PhotoMetadata verilerine erişme
Android için Yerler SDK'sı (Yeni), PhotoMetadata
sınıfına AuthorAttributions
alanını ekler. Uygulamanız yeni SDK'yı etkinleştirirse Place.getPhotoMetadas()
tarafından döndürülen PhotoMetadata
nesnesi bir veya daha fazla yazar ilişkilendirmesi içerebilir.
PhotoMetadata
nesnesi, 3.3.0 sürümünde eklenen yeni yazar ilişkilendirmeleri veya 3.2.0 ve önceki sürümlerde bulunan mevcut atıflar gibi bir atıf içerdiğinde bunları fotoğrafla birlikte görüntülemeniz gerekir. Her tür ilişkilendirmenin ele alınması hakkında daha fazla bilgi için İlişkilendirmeler bölümüne bakın.
PhotoMetadata
nesnesini yazar ilişkilendirmeleriyle doldurmak için şunları yapmanız gerekir:
- Google Cloud projenizi oluştururken yeni SDK'yı etkinleştirin.
- Bir etkinlik veya parça içinde yeni SDK'yı başlatın.
- Yer ayrıntıları isteğinin alan listesine
Place.Field.PHOTO_METADATAS
özelliğini ekleyin. Place
nesnesini almak içinPlacesClient.fetchPlace()
vePhotoMetadata
nesnesini almak içinPlace.getPhotoMetadas()
yöntemini çağırın. Yazar atıfları alanı,PlacesClient.findCurrentPlace()
tarafından desteklenmez.- Yazar ilişkilendirmelerini almak için
PhotoMetadata.getAuthorAttributions()
kodunu kullanın.
Fotoğraf çekin
Bu bölümde, bir fotoğrafın bit eşlem veya URI olarak nasıl alınacağı açıklanmaktadır.
Bit eşlem olarak yer fotoğrafı alma
Aşağıdaki örnekte bir yer fotoğrafının bit eşlem olarak alınması 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. } }); });
Bir yer fotoğrafı URI'si alma
Aşağıdaki örnekte bir yer fotoğrafı URI'sinin alınması gösterilmektedir.
// 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. } }); });
İlişkilendirmeler
Çoğu durumda, yer fotoğrafları atıfta bulunulmadan kullanılabilir veya gerekli atıf resmin parçası olarak dahil edilir. Ancak PhotoMetadata
türündeki fotoğraf meta veri nesnesi, iki ek ilişkilendirme türünden birini içerebilir:
PhotoMetadata.getAttributions()
tarafından erişilen bir ilişkilendirme dizesi olan Attributions.PhotoMetadata.getAuthorAttributions()
tarafından erişilen birAuthorAttributions
nesnesi olan AuthorAttributions.
Döndürülen PhotoMetadata
nesnesi, her iki ilişkilendirme türünü de içeriyorsa görüntüyü görüntülediğiniz her yerde ilişkilendirmeyi uygulamanıza eklemeniz gerekir. Daha fazla bilgi için İlişkilendirmeleri Görüntüleme bölümüne bakın.
Kullanım ve faturalandırma
fetchPhoto()
ürününe yapılan aramalar için Yer Fotoğrafı SKU'su ücretlendirilir.
Ayrıntılar için Kullanım ve Faturalandırma sayfasını inceleyin.