אתם יכולים להשתמש ב-Places SDK ל-Android (דור קודם) כדי לבקש תמונה של מקום ולהציג אותה באפליקציה. התמונות שמוחזרות על ידי שירות התמונות מגיעות ממגוון מקורות, כולל בעלי עסקים ותמונות שנוספו על ידי משתמשים.
Places SDK ל-Android (דור קודם) מחזיר תמונת מפת סיביות בגודל מקסימלי של 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 = 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, יכול להכיל אחד משני סוגים של שיוכים נוספים:
- Attributions, מחרוזת שיוך שאפשר לגשת אליה באמצעות
PhotoMetadata.getAttributions(). - AuthorAttributions, אובייקט
AuthorAttributionsשאפשר לגשת אליו באמצעותPhotoMetadata.getAuthorAttributions().
אם האובייקט PhotoMetadata שמוחזר כולל אחד מסוגי השיוך, צריך לכלול את השיוך באפליקציה בכל מקום שבו מוצגת התמונה. מידע נוסף זמין במאמר הצגת מאפיינים.
שימוש וחיוב
מק"ט של Place Photos (דור קודם) מחויב על קריאות ל-fetchPhoto().
פרטים נוספים זמינים בדף שימוש וחיוב.