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

Interfejs Places API obsługuje istniejące zdjęcia miejsc. Jeśli znasz dotychczasowe Zdjęcie miejsca, nowa wersja Zdjęcia miejsca wprowadza te zmiany:

  • Nowa usługa Zdjęcie miejsca wymaga podania nazwy zasobu zdjęcia, która zawiera identyfikator miejsca w adresie URL żądania, zamiast tylko odwołania do zdjęcia. Więcej informacji: Zmiana odwołań do zdjęć
  • Nowa usługa Zdjęcie miejsca obsługuje jako mechanizm uwierzytelniania zarówno klucze API, jak i tokeny OAuth.

W tabeli poniżej znajdziesz parametry w dotychczasowej funkcji Zdjęcie miejsca, które zostały zmienione lub zmodyfikowane w nowej funkcji Zdjęcie miejsca, a także parametry, które nie są już obsługiwane.

Parametr prądu Nowy parametr Uwagi
maxheight maxHeightPx Musisz podać jedną z tych wartości: maxHeightPx, maxWidthPx lub oba.
maxwidth maxWidthPx Musisz podać jedną z tych wartości: maxHeightPx, maxWidthPx lub oba.

Zwiększony rozmiar zdjęć

Istniejące zdjęcie miejsca obsługuje maksymalną liczbę zdjęć rozmiaru 1600 x 1600 pikseli. Funkcja Umieść zdjęcie (nowa) obsługuje rozmiary do 4800 x 4800 pikseli.

Zmień na odwołania do zdjęć

Nowy Zdjęcie miejsca Interfejs API wymaga podania nazwy zasobu żądanego zdjęcia, która zawiera identyfikator miejsca oraz odniesienie do zdjęcia w postaci:

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

Nowe wersje wyszukiwania w pobliżu, wyszukiwania tekstowego i szczegółowych informacji o miejscu 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 atrybucje. 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

Istniejąca funkcja Znajdź miejsce, Wyszukiwanie w pobliżu, wyszukiwanie tekstowe oraz Wszystkie szczegóły miejsca zwracają tablicę photos[] w funkcji odpowiedź obsługującą ten format. Każdy element photo w istniejącym odpowiedź 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.
.