אתם יכולים להשתמש ב-Places SDK ל-Android (מדור קודם) כדי לשלוח בקשה לתמונה של מקום מסוים ולהציג אותה באפליקציה. התמונות שמוחזרות על ידי שירות התמונות מגיעות ממגוון מקורות, כולל תמונות שנוספו על ידי בעלי עסקים ותמונות שנוספו על ידי משתמשים.
Places SDK ל-Android (מדור קודם) מחזיר תמונת bitmap בגודל מקסימלי של 1,600 על 1,600 פיקסלים.
תהליך אחזור התמונות
כדי לאחזר תמונה של מקום:
- משתמשים ב-Place Details (Legacy) כדי לאחזר אובייקט
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 (Legacy) מחויב על קריאות ל-fetchPhoto().
פרטים נוספים מופיעים בדף Usage and Billing.