Przenieś do zdjęcia miejsca (nowość)

Interfejs Places API obsługuje zdjęcie miejsca (starsza wersja). Jeśli znasz usługę Zdjęcie miejsca (starsza wersja), Z nową wersją Zdjęcia miejsca:

  • Aby użyć funkcji Zdjęcie miejsca (nowa), musisz przekazać nazwę zasobu zdjęcia, która zawiera identyfikator miejsca w adresie URL żądania, zamiast tylko odwołania do zdjęcia. Więcej informacji znajdziesz w artykule Zmienianie odwołań do zdjęć.
  • Narzędzie Place Photo (Nowe) obsługuje mechanizm uwierzytelniania oparty na kluczach API i OAuth.

W tabeli poniżej znajdują się parametry w usługach Zdjęcie miejsca (starsza wersja), które zostały zmienione lub zmodyfikowane w usługach Zdjęcie miejsca (nowa wersja), oraz parametry, które nie są już obsługiwane.

Parametr prądu Nowy parametr Uwagi
maxheight maxHeightPx Należy określić kolumnę maxHeightPx, maxWidthPx lub obie te kolumny.
maxwidth maxWidthPx Należy określić kolumnę maxHeightPx, maxWidthPx lub obie te kolumny.

Zwiększony rozmiar zdjęć

Zdjęcie w usługach Google (starsza wersja) obsługiwało maksymalny rozmiar zdjęcia 1600 x 1600 pikseli. Funkcja Umieść zdjęcie (nowa) obsługuje rozmiary do 4800 x 4800 pikseli.

Zmiana odwołań do zdjęć

Place Photo (nowy) Interfejs API wymaga podania nazwa zasobu żądanego zdjęcia, która zawiera identyfikator miejsca i odniesienie do zdjęcia w formacie:

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

Wyszukiwanie w pobliżu (nowy), wyszukiwanie tekstowe (nowy) i szczegóły miejsca (nowy) zwracają w odpowiedzi tablicę photos[], która obsługuje ten format. Każdy element photos[] w nowej odpowiedzi zawiera te pola:

  • name – ciąg tekstowy zawierający nazwę zasobu zdjęcia. Ten ciąg ma postać:

    places/PLACE_ID/photos/PHOTO_REFERENCE
  • heightPx – maksymalna wysokość obrazu w pikselach.
  • widthPx – maksymalna szerokość obrazu w pikselach.
  • authorAttributions[] – wszelkie wymagane informacje o autorze. To pole jest zawsze obecne, ale może być puste.

W przypadku dotychczasowego interfejsu API wystarczy przekazać odwodnienie do zdjęcia w formie:

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

Funkcje Znajdź miejsce (starsza wersja), Wyszukiwanie w pobliżu (starsza wersja), Wyszukiwanie tekstowe (starsza wersja) i Szczegóły miejsca (starsza wersja) zwracają tablicę photos[] w odpowiedzi, która obsługuje ten format. Każdy element photo w starszej odpowiedzi zawiera te pola:

  • photo_reference – ciąg znaków służący do identyfikowania zdjęcia podczas wykonywania żądania dotyczącego zdjęcia.
  • height – maksymalna wysokość obrazu.
  • width – maksymalna szerokość obrazu.
  • html_attributions[] – wszelkie wymagane informacje o autorze. To pole jest zawsze obecne, ale może być puste.