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/ChIJ2fzCmcW7j4AR2JzfXBBoh6EUnten 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:
![Bild „Kontingent überschritten“](https://developers.google.cn/static/maps/documentation/maps-static/images/quota.png?authuser=6&hl=de)
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
nochmaxWidthPx
. - Der Wert des Parameters
maxHeightPx
odermaxWidthtPx
wurde festgelegt annull
. name
ist abgelaufen. Wenn diename
abläuft, an Place Details (New), Nearby Search (New), oder Text Search (New), um ein neuesname
.
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:
- Klicken Sie auf das API-Symbol
. rechts auf der Seite.
- Legen Sie für den Parameter
name
Folgendes fest:places/PLACE_ID/photos/PHOTO_RESOURCE/media
- Legen Sie
skipHttpRedirect
auftrue
fest, damit die Anfrage eine JSON-Datei zurückgibt Antwort. Standardmäßig gibt die Anfrage das Bild zurück, das vom API Explorer - 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.
Klicken Sie im API Explorer auf das Symbol zum Maximieren
, um das API Explorer-Fenster zu maximieren.