תמונות של המקום

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

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

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

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

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

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

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

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

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.
        }
    });
});

הערה: מידע נוסף על אתחול PlacesClient זמין במאמר בנושא אתחול לקוח Places API.

שיוכים

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

שיוכים, מחרוזת שיוך שאפשר לגשת אליה דרך PhotoMetadata.getAttributions().
‫AuthorAttributions, אובייקט AuthorAttributions שאליו ניגשים באמצעות PhotoMetadata.getAuthorAttributions().

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

שימוש וחיוב

חיוב על מק"ט של Places Photo מתבצע על קריאות ל-fetchPhoto(). פרטים נוספים זמינים בדף Usage and Billing.

תמונות של המקום קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

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

Kotlin

Java

שיוכים

שימוש וחיוב

תמונות של המקום