Places API obsługuje Zdjęcie miejsca. Jeśli znasz już istniejące Zdjęcia miejsca, nowa wersja Miejsc Zdjęcia wprowadza następujące zmiany:
- Aby korzystać z nowej usługi Zdjęcia miejsca, musisz: przekazać nazwę zasobu zdjęcia, w tym identyfikator miejsca w adresu URL żądania, a nie samego zdjęcia. Więcej informacji: Zmienianie odwołań do zdjęć
- Nowa usługa Zdjęcia miejsc obsługuje Klucze interfejsu API i OAuth tokeny uwierzytelniania.
Poniższa tabela zawiera parametry w obecnym Zdjęcie miejsca, którego nazwa została zmieniona lub zmodyfikowano dla nowe zdjęcie miejsca oraz parametry, które już nie są obsługiwane.
Bieżący parametr | 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ęcia
Istniejące zdjęcie miejsca obsługuje maksymalną liczbę zdjęć rozmiaru 1600 x 1600 pikseli. Zdjęcie miejsca (nowe) 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
Wyszukiwanie tekstowe i szczegóły miejsca
wszystkie zwracają tablicę photos[]
w odpowiedzi, która obsługuje ten format. Każdy
element photos[]
w nowej odpowiedzi zawiera te pola:
name
– ciąg tekstowy zawierający nazwę zasobu dla argumentu zdjęcie. 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. Ten pole jest zawsze obecne, ale może być puste.
W obecnym interfejsie API musisz tylko przekazać odwołanie do zdjęcia w polu formularz:
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 tekstowy służący do rozpoznawania zdjęcia, gdy i wysyłania prośby o zdjęcia.height
– maksymalna wysokość obrazu.width
– maksymalna szerokość obrazu.html_attributions[]
– wszelkie wymagane atrybucje. Ten pole jest zawsze obecne, ale może być puste.