Yerin Fotoğrafları

Platform seçin: Android iOS JavaScript Web Hizmeti

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:

  1. Bir Place nesnesini getirmek için Yer Ayrıntıları'nı kullanın (fetchPlace() veya findCurrentPlace() kullanın). Place.Field PHOTO_METADATAS alanını, yanıt Place nesnesine dahil edilecek alanlar listesine eklediğinizden emin olun.
  2. FetchPlaceResponse veya FindCurrentPlaceResponse için OnSuccessListener'nda:
    1. Yanıt Place nesnesinden PhotoMetadata türündeki fotoğraf meta veri nesnesini almak için Place.getPhotoMetadas() kullanın.
    2. Bit eşlem resmi almak için:
      1. İ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.
      2. Fotoğraf bit eşlemi istemek için PlacesClient.fetchPhoto() aracını kullanın.
      3. OnSuccessListener ekleyin ve FetchPhotoResponse konumundan fotoğraf alın.
    3. Fotoğraf URI'si almak için:
      1. İ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.
      2. Fotoğraf URI'sini istemek için PlacesClient.fetchResolvedPhotoUri() öğesini kullanın.
      3. Bir OnSuccessListener ekleyin ve FetchResolvedPhotoUriResponse nesnesinden fotoğraf URI'sini alın.

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:

  1. Google Cloud projenizi oluştururken yeni SDK'yı etkinleştirin.
  2. Bir etkinlik veya parça içinde yeni SDK'yı başlatın.
  3. Yer ayrıntıları isteğinin alan listesine Place.Field.PHOTO_METADATAS özelliğini ekleyin.
  4. Place nesnesini almak için PlacesClient.fetchPlace() ve PhotoMetadata nesnesini almak için Place.getPhotoMetadas() yöntemini çağırın. Yazar atıfları alanı, PlacesClient.findCurrentPlace() tarafından desteklenmez.
  5. 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:

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.