Foto des Orts (neu)

Das Ortsfoto (Neu) ist eine schreibgeschützte API, mit der Sie fotografischen Inhalten hinzufügen. Der Place Photo-Dienst greifen Sie auf die Millionen von Fotos in der Places-Datenbank zu.

Wenn Sie Ortsinformationen über eine „Place Details“-, „Nearby Search“- oder „Text Search“-Anfrage abrufen, können Sie auch Fotoressourcen für relevante fotografische Inhalte anfordern. Mit dem Fotodienst können Sie auf die referenzierten Fotos zugreifen und das Bild auf die optimale Größe für Ihr .

Mit dem API Explorer können Sie Live-Anfragen stellen, damit Sie sich mit der API und den API-Optionen:

Testen!

Place Photo-Anfragen

Eine Ortsfotoanfrage 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, maxWidthPx-Parameter oder beides.

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

Erforderliche Parameter

Name des Fotos

Ein String-Identifikator, der ein Foto eindeutig identifiziert. Fotonamen werden von einem Place Details (New), Nearby Search (New) oder Text Search (New)-Anfrage in der Eigenschaft name jedes Elements des Arrays photos[].

Ein Beispiel finden Sie unter Fotonamen auswählen.

maxHeightPx und maxWidthPx

Gibt die maximal gewünschte Höhe und Breite des Bildes in Pixeln an. Wenn das Bild kleiner ist als die angegebenen Werte sind, wird das Originalbild zurückgegeben. Ist das Bild in einem der folgenden Bereiche größer wird sie auf die kleinere der beiden Dimensionen skaliert, wobei die ursprüngliche Größe begrenzt ist. Seitenverhältnis. Für die Properties „maxheight“ und „maxwidth“ ist eine Ganzzahl zwischen 1 und 4.800 zulässig.

Sie müssen entweder maxHeightPx, maxWidthPx oder beide angeben.

Optionale Parameter

skipHttpRedirect

Wenn false (Standardeinstellung) ist, erstellen Sie eine HTTP-Weiterleitung zum Bild, 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 bei Nicht-HTTP-Anfragen ignoriert.

Fotoname auswählen

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

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

• name: Ein String, der den Ressourcennamen des Fotos enthält, wenn Sie eine Fotoanforderung aus. Diese Zeichenfolge hat das Format:

  places/PLACE_ID/photos/PHOTO_RESOURCE

• heightPx: Die maximale Höhe des Bildes in Pixeln.
• widthPx: Die maximale Breite des Bildes in Pixeln.
• authorAttributions[]: alle erforderlichen Quellenangaben. Dieses ist immer vorhanden, kann aber leer sein.

Vom Fotodienst zurückgegebene Fotos stammen aus verschiedenen Quellen, z. B. von Geschäftsinhabern und von Nutzern erstellten Fotos. In den meisten Fällen Fotos können ohne Namensnennung verwendet werden oder verfügen über die erforderliche Namensnennung. als Teil des Bildes enthalten sind. Wenn das zurückgegebene photo-Element einen Wert im Feld authorAttributions enthält, müssen Sie den Parameter zusätzliche Attribution in Ihrer Anwendung, wo immer Sie das Bild anzeigen.

Das folgende Beispiel zeigt eine „Place Details“-Anfrage, bei der photos in Die Feldmaske, sodass die Antwort das Array photos[] in der Antwort 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"
          }
        ]
      },    ...

Foto von Ort anfordern

In der folgenden Beispielanfrage wird ein Bild mit seiner Ressource name zurückgegeben und seine Größe so angepasst, dass sie höchstens 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 einer erfolgreichen Ortsfotoanforderung ist ein Bild. Die Art des Bildes hängt von der Art des ursprünglich eingereichten Fotos ab.

Wenn Ihre Anfrage Ihr verfügbares Kontingent überschreitet, gibt der Server eine HTTP 403-Status und zeigen Sie mit dem Bild unten an, dass das Kontingent überschritten:

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

• Der Name des eingereichten Fotos wurde nicht richtig angegeben.
• Die Anfrage enthielt weder maxHeightPx noch maxWidthPx .
• Der Wert des Parameters maxHeightPx oder maxWidthtPx wurde festgelegt an null.
• name ist abgelaufen. Wenn die name abläuft, an Place Details (New), Nearby Search (New), oder Text Search (New), um ein neues name.

Testen!

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

So stellen Sie eine Anfrage:

1. Klicken Sie auf das API-Symbol . rechts auf der Seite.
2. Legen Sie für den Parameter name Folgendes fest:

   places/PLACE_ID/photos/PHOTO_RESOURCE/media

3. Legen Sie skipHttpRedirect auf true fest, damit die Anfrage eine JSON-Datei zurückgibt Antwort. Standardmäßig gibt die Anfrage das Bild zurück, das vom API Explorer
4. Klicken Sie auf die Schaltfläche Execute (Ausführen). Wählen Sie im Pop-up-Fenster das Konto aus, verwenden, um die Anfrage zu stellen.

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