Zu Place Photo migrieren (Neu)

Places API unterstützt die bestehende Ortsfoto. Wenn Sie mit dem bereits vorhandenen Place Photo vertraut sind, wird das neue Version von Place Photo nimmt folgende Änderungen vor:

  • Für den neuen Place Photo-Dienst müssen Sie übergeben Sie den Ressourcennamen des Fotos, der die Orts-ID im -Anforderungs-URL statt nur der Fotoreferenz. Weitere Informationen finden Sie unter Zu Fotoreferenzen wechseln
  • Der neue Place Photo-Dienst unterstützt sowohl API-Schlüssel und OAuth als Authentifizierungsmechanismus.

In der folgenden Tabelle sind die Parameter der vorhandenen Ortsfoto, das für die eines neuen Ortsfotos oder Parameter, die nicht mehr unterstützt.

Aktueller Parameter Neuer Parameter Hinweise
maxheight maxHeightPx Sie müssen entweder maxHeightPx, maxWidthPx oder beides.
maxwidth maxWidthPx Sie müssen entweder maxHeightPx, maxWidthPx oder beides.

Fotos vergrößert

Das vorhandene Ortsfoto unterstützt die maximale Anzahl von Fotos. Größe von 1600 x 1600 Pixel. Ortsfoto (Neu) unterstützt Größen von bis zu 4.800 x 4.800 Pixeln.

Zu Fotoreferenzen ändern

Das neue Ortsfoto Für die API muss der Ressourcenname des angeforderten Fotos übergeben werden, eine Orts-ID und den Fotoverweis im folgenden Format enthält:

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

Die neuen Versionen von Nearby Search, „Text Search“ und „Place Details“ Alle geben in der Antwort ein photos[]-Array zurück, das dieses Format unterstützt. Jedes -Element von photos[] in der neuen Antwort enthält die folgenden Felder:

  • name: Ein String, der den Ressourcennamen der Foto. Dieser String hat das Format:

    places/PLACE_ID/photos/PHOTO_REFERENCE
  • 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.

Mit der vorhandenen API müssen Sie lediglich die Fotoreferenz im Feld Formular:

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

Das vorhandene Find Place, Nearby Search, Text Search und Bei „Place Details“-Anfragen wird ein photos[]-Array im Antwort, die dieses Format unterstützt. Jedes photo-Element im vorhandenen Antwort enthält die folgenden Felder:

  • photo_reference: Ein String, mit dem das Foto identifiziert werden kann, wenn Sie eine Fotoanforderung aus.
  • height: Die maximale Höhe des Bildes.
  • width: Die maximale Breite des Bilds.
  • html_attributions[]: alle erforderlichen Quellenangaben. Dieses ist immer vorhanden, kann aber leer sein.