Wprowadzenie
Interfejs Places API obsługuje Place Photos (starsza wersja). Jeśli znasz Zdjęcia miejsc (starsza wersja), Zdjęcia miejsc (nowa wersja) wprowadza następujące zmiany:
- Usługa Place Photos (New) wymaga, aby w adresie URL żądania przekazywać nazwę zasobu zdjęcia, która zawiera identyfikator miejsca, a nie tylko odwołanie do zdjęcia. Więcej informacji znajdziesz w artykule Zmiana dotycząca zdjęć referencyjnych.
- Zdjęcia miejsc (nowa wersja) obsługują jako mechanizm uwierzytelniania zarówno klucze interfejsu API, jak i tokeny OAuth.
W tabeli poniżej znajdziesz parametry z interfejsu Place Photos (starsza wersja), które zostały zmienione lub zmodyfikowane w interfejsie Place Photos (nowa wersja), oraz parametry, które nie są już obsługiwane.
| Bieżący parametr | Nowy parametr | Uwagi |
|---|---|---|
maxheight |
maxHeightPx |
Musisz podać maxHeightPx, maxWidthPx lub oba te atrybuty. |
maxwidth |
maxWidthPx |
Musisz podać maxHeightPx, maxWidthPx lub oba te atrybuty. |
Większy rozmiar zdjęcia
Place Photos (starsza wersja) mogły mieć maksymalnie 1600 × 1600 pikseli. Zdjęcia miejsc (nowa wersja) obsługują rozmiary do 4800 x 4800 pikseli.
Przejście na odniesienia do zdjęć
Interfejs Place Photos (New) wymaga przekazania nazwy zasobu żądanego zdjęcia, która zawiera identyfikator miejsca i odwołanie do zdjęcia w formacie:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Wyszukiwanie w pobliżu (nowa wersja), wyszukiwanie tekstowe (nowa wersja) i informacje o miejscu (nowa wersja) 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 znaków ma postać:places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx– maksymalna wysokość obrazu w pikselach.widthPx– maksymalna szerokość obrazu w pikselach.authorAttributions[]– wszelkie wymagane informacje o autorze. To pole jest zawsze obecne, ale może być puste.
W przypadku starszej wersji interfejsu API wystarczy przekazać odwołanie do zdjęcia w formacie:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Usługi Znajdź miejsce (starsza wersja), Wyszukiwanie w pobliżu (starsza wersja), Wyszukiwanie tekstowe (starsza wersja) i informacje o miejscu (starsza wersja) zwracają w odpowiedzi tablicę photos[], która obsługuje ten format. Każdy element photo w odpowiedzi starszego typu zawiera te pola:
photo_reference– ciąg znaków używany do identyfikowania zdjęcia podczas wysyłania prośby o zdjęcie.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.