Places API obsługuje istniejące zdjęcie miejsca. Jeśli znasz istniejące zdjęcie miejsca, nowa wersja zdjęcia miejsca wprowadzi te zmiany:
- Nowa usługa zdjęć miejsc wymaga przesłania nazwy zasobu zdjęcia, która zawiera identyfikator miejsca w adresie URL żądania, a nie tylko w postaci odniesienia do zdjęcia. Więcej informacji znajdziesz w artykule o zmianie dotyczącej plików referencyjnych dotyczących zdjęć.
- Nowa usługa Place Photo obsługuje zarówno tokeny API interfejsu API, jak i tokeny OAuth jako mechanizm uwierzytelniania.
W tabeli poniżej znajdziesz parametry istniejącego zdjęcia miejsca, które zostały zmienione lub zmodyfikowane w związku z nowym zdjęciem miejsca, bądź parametry, które nie są już obsługiwane.
Bieżący parametr | Nowy parametr | Uwagi |
---|---|---|
maxheight |
maxHeightPx |
Musisz określić maxHeightPx , maxWidthPx lub oba. |
maxwidth |
maxWidthPx |
Musisz określić maxHeightPx , maxWidthPx lub oba. |
Zwiększono rozmiar zdjęcia
Dotychczasowe zdjęcie miejsca obsługiwało maksymalny rozmiar 1600 x 1600 pikseli. Zdjęcie miejsca (nowość) obsługuje rozmiar do 4800 x 4800 pikseli.
Zmień na odwołania do zdjęć
Nowy interfejs API Place Photo wymaga przekazania nazwy zasobu żądanego zdjęcia, w tym identyfikatora miejsca i dokumentu referencyjnego 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 szczegółów miejsc zwracają w odpowiedzi tablicę photos[]
, która obsługuje ten format. Każdy element photos[]
w nowej odpowiedzi zawiera te pola:
name
– ciąg znaków zawierający nazwę zasobu zdjęcia. Ma on postać:places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx
– maksymalna wysokość obrazu w pikselach.widthPx
– maksymalna szerokość obrazu w pikselach.authorAttributions[]
– wszystkie wymagane atrybucje. To pole jest zawsze obecne, ale może być puste.
Przy obecnym interfejsie API musisz tylko przesłać dokument referencyjny zdjęcia w formacie:
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 i Szczegóły miejsca zwraca w odpowiedzi tablicę photos[]
, która obsługuje ten format. Każdy element photo
w istniejącej odpowiedzi zawiera te pola:
photo_reference
– ciąg znaków używany do identyfikowania zdjęcia, gdy wysyłasz żądanie dotyczące zdjęcia.height
– maksymalna wysokość obrazu.width
– maksymalna szerokość obrazu.html_attributions[]
– wszystkie wymagane atrybucje. To pole jest zawsze obecne, ale może być puste.