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 ein Foto eines Orts ist eine HTTP-GET-Anfrage an eine URL im folgenden Format: 
https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS

Dabei sind die folgenden Parameter 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.

Unten finden Sie eine vollständige Liste der erforderlichen und optionalen Parameter.

Erforderliche Parameter

Name des Fotos

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

Ein Beispiel finden Sie unter Namen eines Fotos abrufen.

maxHeightPx und maxWidthPx

Gibt die maximale gewünschte Höhe und Breite des Bilds in Pixeln an. Wenn das Bild kleiner als die angegebenen Werte ist, wird das Originalbild zurückgegeben. Wenn das Bild in einer der beiden Dimensionen größer ist, wird es so skaliert, dass es der kleineren der beiden Dimensionen entspricht, wobei das ursprüngliche Seitenverhältnis beibehalten wird. 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, überspringe die Weiterleitung und gib 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.

Namen eines Fotos abrufen

Alle Anfragen an den Place Photo-Dienst müssen den Namen einer Fotoressource 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 es für den Ort entsprechende Fotos gibt.

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

  • name: Ein String, der den Ressourcennamen des Fotos enthält, wenn Sie eine Fotoanfrage stellen. 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überschreitung

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

  • 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 den name-Parameter auf Folgendes 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 Explorer zu maximieren.