Wprowadzenie
Places API obsługuje Place Photos (wersja starsza). Jeśli znasz Place Photos (wersja starsza), Place Photos (wersja nowa) wprowadzono te zmiany:
- Place Photos (New) wymaga, aby w adresie URL żądania przekazać nazwę zasobu zdjęcia, która zawiera identyfikator miejsca, a nie tylko odniesienie do zdjęcia. Więcej informacji znajdziesz w artykule Zmiana odniesień do zdjęć.
- Zdjęcia miejsc (wersja nowa) obsługują zarówno klucze API , jak i OAuth jako mechanizm uwierzytelniania.
W tabeli poniżej znajdziesz parametry w zdjęciach miejsc (wersja starsza), które zostały zmienione lub zmodyfikowane w przypadku zdjęć miejsc (wersja nowa), oraz parametry, które nie są już obsługiwane.
| Aktualny parametr | Nowy parametr | Uwagi |
|---|---|---|
maxheight |
maxHeightPx |
Musisz określić maxHeightPx,
maxWidthPx, lub oba te parametry. |
maxwidth |
maxWidthPx |
Musisz określić maxHeightPx,
maxWidthPx, lub oba te parametry. |
Zwiększony rozmiar zdjęcia
Place Photos (starsza wersja) obsługiwały maksymalny rozmiar zdjęcia 1600 x 1600 pikseli. Place Photos (wersja nowa) obsługują rozmiary do 4800 x 4800 pikseli.
Zmiana odniesień do zdjęć
Interfejs API zdjęć miejsc (wersja nowa) wymaga, aby w żądaniu przekazać nazwę zasobu żądanego zdjęcia, która zawiera identyfikator miejsca i odniesienie do zdjęcia w tym formacie:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Wyszukiwanie w pobliżu (wersja nowa), wyszukiwanie tekstowe (wersja nowa) i informacje o miejscu (wersja nowa) 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 tekstowy ma format:places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx– maksymalna wysokość obrazu w pikselach.widthPx– maksymalna szerokość obrazu w pikselach.authorAttributions[]– wszystkie wymagane informacje o autorze. To pole jest zawsze obecne, ale może być puste.
W przypadku starszego interfejsu API wystarczy przekazać odniesienie do zdjęcia w tym formacie:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Znajdź miejsce (wersja starsza), wyszukiwanie w pobliżu (wersja starsza), wyszukiwanie tekstowe (wersja starsza) i informacje o miejscu (wersja starsza) zwracają w odpowiedzi tablicę photos[], która obsługuje ten format. Każdy element photo w starszej odpowiedzi zawiera te pola:
photo_reference– ciąg tekstowy używany do identyfikowania zdjęcia podczas wysyłania żądania dotyczącego zdjęcia.height– maksymalna wysokość obrazu.width– maksymalna szerokość obrazu.html_attributions[]– wszystkie wymagane informacje o autorze. To pole jest zawsze obecne, ale może być puste.