Interfejs Places API obsługuje istniejące zdjęcie miejsca. Jeśli znasz już istniejące zdjęcie miejsca, w nowej wersji zdjęcia miejsca wprowadziliśmy te zmiany:
- Nowa usługa Zdjęcia miejsca wymaga podania nazwy zasobu zdjęcia, w tym identyfikatora miejsca w URL-u żądania, a nie tylko odwołania do zdjęcia. Więcej informacji znajdziesz w artykule o zmienianiu odwołań do zdjęć.
- Nowa usługa Place Photo obsługuje jako mechanizm uwierzytelniania zarówno klucze interfejsu API, jak i tokeny OAuth.
Poniższa tabela zawiera listę parametrów w istniejącym zdjęciu miejsca, które zostały zmienione lub zmodyfikowane w przypadku nowego zdjęcia miejsca, a także parametry, które nie są już obsługiwane.
| Bieżący parametr | Nowy parametr | Notatki |
|---|---|---|
maxheight |
maxHeightPx |
Musisz określić maxHeightPx, maxWidthPx lub obie. |
maxwidth |
maxWidthPx |
Musisz określić maxHeightPx, maxWidthPx lub obie. |
Zwiększony rozmiar zdjęcia
Dotychczasowe zdjęcie w miejscu obsługiwało maksymalny rozmiar 1600 x 1600 pikseli. Zdjęcie miejsca (nowe) obsługuje wymiary do 4800 x 4800 pikseli.
Zmień na odwołania do zdjęć
Nowy interfejs API Place Photo wymaga podania nazwy zasobu żądanego zdjęcia, w tym identyfikatora miejsca oraz referencji zdjęcia w formacie:
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 informacji o miejscach 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. Ma on format: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 obecnym interfejsie API musisz tylko przekazać odwołanie do zdjęcia w takim formacie:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Istniejące funkcje Znajdź miejsce, Wyszukiwanie w pobliżu, Wyszukiwanie tekstowe i Szczegóły miejsca zwracają w odpowiedzi tablicę photos[], która obsługuje ten format. Każdy element photo w dotychczasowej odpowiedzi zawiera te pola:
photo_reference– ciąg znaków używany do identyfikowania zdjęcia podczas wykonywania żądania zdjęcia.height– maksymalna wysokość obrazu.width– maksymalna szerokość obrazu.html_attributions[]– wszelkie wymagane atrybucje. To pole jest zawsze obecne, ale może być puste.