Place Photos

Plattform auswählen: Android iOS JavaScript Webdienst

Mit dem Places SDK for Android können Sie ein Ortsfoto anfordern, das in Ihrer App angezeigt werden soll. Vom Fotodienst zurückgegebene Fotos stammen aus verschiedenen Quellen, z. B. aus Fotos von Geschäftsinhabern und von Nutzern.

Das Places SDK for Android gibt ein Bitmapbild mit einer maximalen Größe von 1.600 × 1.600 Pixeln zurück.

Fotoabruf

So rufen Sie ein Bild für einen Ort ab:

1. Verwende Place Details, um ein Place-Objekt abzurufen. Verwende entweder fetchPlace() oder findCurrentPlace(). Füge das Feld Place.Field PHOTO_METADATAS in die Liste der Felder ein, die in das Place-Antwortobjekt aufgenommen werden sollen.
2. Verwenden Sie in der OnSuccessListener für FetchPlaceResponse oder FindCurrentPlaceResponse Place.getPhotoMetadas(), um das Fotometadatenobjekt vom Typ PhotoMetadata aus dem Antwortobjekt Place abzurufen.
3. Erstellen Sie ein FetchPhotoRequest-Objekt und geben Sie optional die maximale Höhe und Breite (in Pixeln) an. Fotos dürfen eine maximale Breite oder Höhe von 1.600 Pixeln haben.
4. Fordern Sie mit PlacesClient.fetchPhoto() die Bitmap des Fotos an.
5. Füge eine OnSuccessListener hinzu und rufe das Foto aus der FetchPhotoResponse ab.

Foto aufnehmen

Sie können mit CancellationToken versuchen, eine Anfrage an eine der Anfrageklassen abzubrechen, z. B. FetchPlaceRequest. Der Abbruch erfolgt auf Best-Effort-Basis. Nachdem ein Kündigungsantrag gestellt wurde, erhalten Sie keine Antwort. Das Ausstellen eines Abbruchtokens garantiert NICHT, dass eine bestimmte Anfrage abgebrochen wird. Die Anfrage kann Ihnen auch dann in Rechnung gestellt werden, wenn keine Antwort zurückgegeben wird.

Das folgende Beispiel zeigt, wie Sie ein Foto abrufen:

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

      

Attribution

In den meisten Fällen dürfen Ortsfotos ohne Quellenangabe verwendet werden oder die erforderlichen Quellenangaben sind Teil des Bildes. Das Metadatenobjekt für Fotos vom Typ PhotoMetadata kann jedoch zwei Arten zusätzlicher Quellenangaben enthalten:

• Attributions: ein Attributionsstring, auf den PhotoMetadata.getAttributions() zugreift.
• AuthorAttributions, ein AuthorAttributions-Objekt, auf das über PhotoMetadata.getAuthorAttributions() zugegriffen wird.

Wenn das zurückgegebene PhotoMetadata-Objekt einen der beiden Attributionstypen enthält, müssen Sie die Quellenangabe überall dort in Ihre Anwendung aufnehmen, wo das Bild angezeigt wird. Weitere Informationen finden Sie unter Zuordnungen anzeigen.

Nutzung und Abrechnung

Die SKU Places Photo wird für Aufrufe von fetchPhoto() berechnet. Weitere Informationen finden Sie auf der Seite Nutzung und Abrechnung.