תמונות של המקום (קודם)

מפתחים באזור הכלכלי האירופי (EEA)

אתם יכולים להשתמש ב-Places SDK ל-Android (מדור קודם) כדי לשלוח בקשה לתמונה של מקום מסוים ולהציג אותה באפליקציה. התמונות שמוחזרות על ידי שירות התמונות מגיעות ממגוון מקורות, כולל תמונות שנוספו על ידי בעלי עסקים ותמונות שנוספו על ידי משתמשים.

‫Places SDK ל-Android (מדור קודם) מחזיר תמונת bitmap בגודל מקסימלי של 1,600 על 1,600 פיקסלים.

תהליך אחזור התמונות

כדי לאחזר תמונה של מקום:

  1. משתמשים ב-Place Details (Legacy) כדי לאחזר אובייקט Place (באמצעות fetchPlace()). חשוב לכלול את השדה Place.Field PHOTO_METADATAS ברשימת השדות שייכללו באובייקט התגובה Place.
  2. ב-OnSuccessListener של FetchPlaceResponse, משתמשים ב-Place.getPhotoMetadas() כדי לקבל את אובייקט המטא-נתונים של התמונה, מסוג PhotoMetadata, מאובייקט התגובה Place.
  3. יוצרים אובייקט FetchPhotoRequest, אפשר לציין גובה ורוחב מקסימליים (בפיקסלים). הרוחב או הגובה המקסימליים של התמונות הם 1,600 פיקסלים.
  4. משתמשים ב-PlacesClient.fetchPhoto() כדי לבקש את מפת הסיביות של התמונה.
  5. מוסיפים OnSuccessListener ומקבלים את התמונה מ-FetchPhotoResponse.

איך מקבלים תמונה

בדוגמה הבאה מוצג איך מקבלים תמונה של מקום:

Kotlin

// Define a Place ID.
val placeId = PlaceIdProvider.getRandomPlaceId()

// 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 metadata = place.photoMetadatas
        if (metadata == null || metadata.isEmpty()) {
            Log.w(TAG, "No photo metadata.")
            return@addOnSuccessListener
        }
        val photoMetadata = metadata.first()

        // Get the attribution text.
        val attributions = photoMetadata?.attributions

        binding.placePhotosAttributions.text = attributions

        // Create a FetchResolvedPhotoUriRequest.
        val photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata)
            .setMaxWidth(500) // Optional.
            .setMaxHeight(300) // Optional.
            .build()
        placesClient.fetchResolvedPhotoUri(photoRequest)
            .addOnSuccessListener { fetchPhotoResponse ->
                val photoUri = fetchPhotoResponse.uri
                Glide.with(this)
                    .load(photoUri)
                    .into(binding.placePhotosResult)
            }.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 = PlaceIdProvider.getRandomPlaceId();

// 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();
    binding.placePhotosAttributions.setText(attributions);

    // Create a FetchResolvedPhotoUriRequest.
    final FetchResolvedPhotoUriRequest photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata)
        .setMaxWidth(500) // Optional.
        .setMaxHeight(300) // Optional.
        .build();
    placesClient.fetchResolvedPhotoUri(photoRequest).addOnSuccessListener((fetchPhotoResponse) -> {
        Glide.with(this)
                .load(fetchPhotoResponse.getUri())
                .into(binding.placePhotosResult);
    }).addOnFailureListener((exception) -> {
        if (exception instanceof ApiException) {
            ApiException apiException = (ApiException) exception;
            Log.e(TAG, "Place not found: " + exception.getMessage());
            final int statusCode = apiException.getStatusCode();
            // TODO: Handle error with given status code.
        }
    });
});

      

שיוכים

ברוב המקרים, אפשר להשתמש בתמונות של מקומות בלי לתת קרדיט, או שהקרדיט הנדרש יופיע כחלק מהתמונה. עם זאת, אובייקט המטא-נתונים של התמונה, מהסוג PhotoMetadata, יכול להכיל אחד משני סוגים של ייחוסים נוספים:

אם אובייקט PhotoMetadata שמוחזר כולל אחד משני סוגי הייחוס, אתם חייבים לכלול את הייחוס באפליקציה בכל מקום שבו התמונה מוצגת. מידע נוסף זמין במאמר בנושא הצגת שיוכים.

שימוש וחיוב

מק"ט Place Photos (Legacy) מחויב על קריאות ל-fetchPhoto(). פרטים נוספים מופיעים בדף Usage and Billing.