Foto des Orts (neu)

Plattform auswählen: Android iOS Webdienst

Der Dienst Place Photo (New) ist eine schreibgeschützte API, mit der Sie Ihrer Anwendung hochwertige Fotos hinzufügen können. Mit dem Place Photos-Dienst können Sie auf Millionen von Fotos in der Places-Datenbank zugreifen.

Wenn Sie über eine „Place Details“-, „Nearby Search“- oder „Text Search“-Anfrage Informationen zum Ort abrufen, können Sie auch Fotoressourcen für relevante Fotos anfordern. Mit dem Fotodienst können Sie auf das referenzierte Foto zugreifen und das Bild auf die für Ihre Anwendung optimale Größe skalieren.

Mit dem API Explorer können Sie Liveanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen:

Testen!

Anfragen für Fotos von Orten

Eine Anfrage für Fotos von Orten ist eine HTTP-GET-Anfrage an eine URL im folgenden Format: 
https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS

Folgende Parameter sind erforderlich:

  • NAME enthält den Ressourcennamen des Fotos.
  • API_KEY enthält den API-Schlüssel.
  • PARAMETERS enthält entweder den Parameter maxHeightPx, den Parameter maxWidthPx oder beide.

Die vollständige Liste der erforderlichen und optionalen Parameter wird unten beschrieben.

Erforderliche Parameter

Name des Fotos

Eine String-ID, die ein Foto eindeutig identifiziert. Fotonamen werden von einer Place Details (New)-, Nearby Search (New)- oder Text Search (New)-Anfrage in der Eigenschaft name jedes Elements des photos[]-Arrays zurückgegeben.

Ein Beispiel finden Sie unter Namen eines Fotos abrufen.

maxHeightPx und maxWidthPx

Gibt die maximal gewünschte Höhe und Breite des Bildes in Pixeln an. Wenn das Bild kleiner als die angegebenen Werte ist, wird das Originalbild zurückgegeben. Ist das Bild in einer der beiden Abmessungen größer, wird es auf die kleinere der beiden Abmessungen skaliert, wobei es auf das ursprüngliche Seitenverhältnis beschränkt ist. Sowohl für die Property „maxheight“ als auch für „maxwidth“ ist eine Ganzzahl zwischen 1 und 4.800 zulässig.

Sie müssen entweder maxHeightPx oder maxWidthPx oder beides angeben.

Optionale Parameter

skipHttpRedirect

Wenn false (Standard) festgelegt ist, wird eine HTTP-Weiterleitung zum Bild erstellt, um das Bild zurückzugeben. Wenn true, überspringen Sie die Weiterleitung und geben Sie eine JSON-Antwort mit den Bilddetails zurück. Beispiel:

{
  "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media",
  "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo"
}

Diese Option wird für Nicht-HTTP-Anfragen ignoriert.

Fotoname auswählen

Alle Anfragen an den „Place Photo“-Dienst müssen einen Fotoressourcennamen enthalten, der in der Antwort auf eine „Nearby Search“-, „Text Search“- oder „Place Details“-Anfrage zurückgegeben wird. Die Antwort auf diese Anfragen enthält ein photos[]-Array, wenn der Ort ähnliche fotografische Inhalte hat.

Jedes Element von photo[] enthält die folgenden Felder:

  • name: Ein String, der den Ressourcennamen des Fotos enthält, wenn Sie eine Fotoanfrage ausführen. Dieser String hat das folgende Format:

    places/PLACE_ID/photos/PHOTO_RESOURCE
  • heightPx: Die maximale Höhe des Bilds in Pixeln.
  • widthPx: Die maximale Breite des Bilds in Pixeln.
  • authorAttributions[] – Alle erforderlichen Quellenangaben. Dieses Feld ist immer vorhanden, kann aber leer sein.

Die vom Fotodienst bereitgestellten Fotos stammen aus unterschiedlichen Quellen, z. B. von Geschäftsinhabern oder Nutzern. In den meisten Fällen dürfen diese Fotos ohne Quellenangabe verwendet werden bzw. sind die erforderlichen Zuordnungen bereits im Bild eingebunden. Wenn das zurückgegebene photo-Element jedoch einen Wert im Feld authorAttributions enthält, müssen Sie die zusätzliche Zuordnung immer dann in Ihre Anwendung einbinden, wenn das Bild zu sehen ist.

Das folgende Beispiel zeigt eine Anfrage für Details zu einem Ort, die photos in der Feldmaske enthält, sodass die Antwort das Array photos[] enthält:

curl -X GET \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,photos" \
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E
 Unten sehen Sie ein Beispiel für ein photos[]-Array in der Antwort. 
    ...
    "photos" : [
      {
        "name": "places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1",
        "widthPx": 6000,
        "heightPx": 4000,
        "authorAttributions": [
          {
            "displayName": "John Smith",
            "uri": "//maps.google.com/maps/contrib/101563",
            "photoUri": "//lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo"
          }
        ]
      },    ...

Fotos von Orten anfordern

In der folgenden Beispielanfrage wird ein Bild mit der Ressource name zurückgegeben, dessen Größe so angepasst wird, dass es maximal 400 Pixel hoch und breit ist:

https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY

Die Antwort auf eine erfolgreiche Place Photo-Anfrage ist ein Bild. Der Bildtyp hängt vom Typ des ursprünglich eingereichten Fotos ab.

Wenn Ihre Anfrage das verfügbare Kontingent überschreitet, gibt der Server den HTTP-Statuscode 403 zurück und zeigt das folgende Bild an, um anzuzeigen, dass das Kontingent überschritten wurde:

Bild für „Kontingent überschritten“

Wenn der Server Ihre Anfrage nicht verstehen kann, gibt er den HTTP-Status 400 zurück, der auf eine ungültige Anfrage hinweist. Dies sind die häufigsten Gründe für eine ungültige Anfrage:

  • Der Name des eingereichten Fotos wurde nicht korrekt angegeben.
  • Die Anfrage enthielt nicht den Parameter maxHeightPx oder maxWidthPx.
  • Der Wert des Parameters maxHeightPx oder maxWidthtPx wurde auf null festgelegt.
  • name ist abgelaufen. Wenn name abläuft, senden Sie eine Anfrage an Place Details (New), Nearby Search (New) oder Text Search (New), um eine neue name zu erhalten.

Testen!

Mit dem API Explorer können Sie Beispielanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen.

So stellen Sie eine Anfrage:

  1. Wählen Sie rechts auf der Seite das API-Symbol Maximieren Sie den API Explorer. aus.
  2. Legen Sie für den Parameter name einen der folgenden Werte fest: 
    places/PLACE_ID/photos/PHOTO_RESOURCE/media
  3. Legen Sie skipHttpRedirect auf true fest, damit die Anfrage eine JSON-Antwort zurückgibt. Standardmäßig gibt die Anfrage das Bild zurück, das im API Explorer nicht angezeigt werden kann.
  4. Klicken Sie auf die Schaltfläche Ausführen. Wählen Sie im Pop-up-Fenster das Konto aus, mit dem Sie die Anfrage stellen möchten.

  5. Klicken Sie im API Explorer-Steuerfeld auf das Symbol zum Maximieren Maximieren Sie den API Explorer., um das Fenster des API Explorers zu maximieren.