Interfejs Places API obsługuje dotychczasową funkcję Zdjęcie miejsca. Jeśli znasz dotychczasową wersję Zdjęcia 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 znajdziesz w artykule Zmienianie odwołań do zdjęć.
- Nowa usługa Zdjęcie miejsca obsługuje mechanizm uwierzytelniania oparty na kluczach API i OAuth.
W tabeli poniżej znajdziesz parametry w dotychczasowym Zdjęciu Miejsca, które zostały zmienione lub zmodyfikowane w nowym Zdjęciu Miejsca, a także parametry, które nie są już obsługiwane.
| Parametr prądu | Nowy parametr | Uwagi |
|---|---|---|
maxheight |
maxHeightPx |
Należy podać kolumnę maxHeightPx,
maxWidthPx lub obie te kolumny. |
maxwidth |
maxWidthPx |
Należy podać kolumnę maxHeightPx,
maxWidthPx lub obie te kolumny. |
Zwiększony rozmiar zdjęć
Dotychczasowe zdjęcie miejsca obsługiwało maksymalny rozmiar 1600 × 1600 pikseli. Funkcja „Umieść zdjęcie” (nowa) obsługuje rozmiary do 4800 x 4800 pikseli.
Zmień odniesienia do zdjęć
Nowy interfejs API Place Photo wymaga podania nazwa zasobu żądanego zdjęcia, która zawiera identyfikator miejsca i odniesienie do zdjęcia w formie:
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[] w formacie obsługiwanym przez ten interfejs. Każdy element photos[] w nowej odpowiedzi zawiera te pola:
name– ciąg znaków 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. 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ące wywołania funkcji Znajdź miejsce, Wyszukaj w pobliżu, Wyszukaj tekst i Szczegóły miejsca zwracają w odpowiedzi tablicę photos[] w formacie obsługiwanym przez ten format. Każdy element photo w dotychczasowej 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 źródłach. To pole jest zawsze obecne, ale może być puste.