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

בחירת פלטפורמה: Android iOS Web Service

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

התכונה "תמונות של מקומות (חדש)" מאפשרת להוסיף לאפליקציה תוכן צילומי באיכות גבוהה. התכונה "תמונות של מקומות" מאפשרת לכם לגשת למיליוני התמונות ששמורות במסד הנתונים של Places. התכונה "תמונות של מקומות" מחזירה URI לתמונת מפת סיביות (bitmap). הגודל המקסימלי של תמונת מפת הסיביות הוא 4,800 על 4,800 פיקסלים.

בקשות של Place Photos

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

  1. משתמשים ב-Place Details (New) כדי לאחזר אובייקט Place באמצעות fetchPlace(). חשוב לכלול את השדה Place.Field PHOTO_METADATAS ברשימת השדות שצריך לכלול באובייקט Place של התגובה.
  2. ב-OnSuccessListener של FetchPlaceResponse, קוראים ל-Place.getPhotoMetadas() כדי לקבל את אובייקט המטא-נתונים של התמונה מסוג PhotoMetadata מאובייקט התגובה Place.
  3. יוצרים אובייקט FetchResolvedPhotoUriRequest כדי לשלוח את הבקשה ומעבירים את אובייקט המטא-נתונים של התמונה, וגם ערכים לגובה המקסימלי, לרוחב המקסימלי או לשניהם.
  4. משתמשים ב-PlacesClient.fetchResolvedPhotoUri() כדי לבקש את ה-URI של התמונה.
  5. מוסיפים OnSuccessListener ומקבלים את ה-URI של התמונה מהאובייקט FetchResolvedPhotoUriResponse.

פרמטרים נדרשים

הפרמטרים הנדרשים ל-FetchResolvedPhotoUriRequest הם:

  • המטא-נתונים של התמונה

    אובייקט המטא-נתונים של התמונה שרוצים להחזיר.

  • גובה מקסימלי או רוחב מקסימלי

    מציין את הגובה והרוחב המקסימליים, בפיקסלים, של התמונה שתוחזר. אם התמונה קטנה מהערכים שצוינו, תוחזר התמונה המקורית. אם התמונה גדולה יותר באחד מהממדים, היא תוקטן בהתאם לממד הקטן יותר מבין השניים, תוך שמירה על יחס הגובה-רוחב המקורי. המאפיינים של הגובה המקסימלי והרוחב המקסימלי מקבלים מספר שלם בין 1 ל-4,800. צריך לציין גובה מקסימלי, רוחב מקסימלי או את שניהם.

    • כדי להגדיר את הפרמטר של הגובה המקסימלי, צריך להפעיל את ה-method‏ setMaxHeight() כשיוצרים את האובייקט FetchResolvedPhotoUriRequest.
    • כדי להגדיר את הפרמטר של הרוחב המקסימלי, צריך להפעיל את השיטה setMaxWidth() כשיוצרים את האובייקט FetchResolvedPhotoUriRequest.

דוגמאות ל-Place Photos

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

// 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
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 and author attributions.
    final String attributions = photoMetadata.getAttributions();
    final AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions();

    // Create a FetchResolvedPhotoUriRequest.
    final FetchResolvedPhotoUriRequest photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata)
        .setMaxWidth(500)
        .setMaxHeight(300)
        .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.
        }
    });
});

שיוכים

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

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