Projekt: /maps/documentation/places/web-service/_project.yaml Książka: /maps/documentation/places/web-service/_book.yaml
Interfejs Places API obsługuje zdjęcia miejsc (starsza wersja). Jeśli znasz Zdjęcia miejsc (starsza wersja), Zdjęcia miejsc (nowa wersja) wprowadza te zmiany:
- W przypadku usługi Zdjęcia w miejscu (nowa) należy przekazać nazwę zasobu zdjęcia, która zawiera identyfikator miejsca w adresie URL żądania, zamiast tylko odwołania do zdjęcia. Więcej informacji znajdziesz w artykule Zmienianie odwołań do zdjęć.
- Aplikacja Place Photos (Nowa) obsługuje jako mechanizm uwierzytelniania zarówno klucze API, jak i OAuth.
W tabeli poniżej znajdują się parametry w usługach Zdjęcia z miejsca (starsza wersja), które zostały zmienione lub zmodyfikowane w usługach Zdjęcia z miejsca (nowa wersja), oraz parametry, które nie są już obsługiwane.
| Parametr prądu | Nowy parametr | Uwagi |
|---|---|---|
maxheight |
maxHeightPx |
Należy określić kolumnę maxHeightPx,
maxWidthPx lub obie te kolumny. |
maxwidth |
maxWidthPx |
Należy określić kolumnę maxHeightPx,
maxWidthPx lub obie te kolumny. |
Zwiększony rozmiar zdjęć
Zdjęcia do umieszczania (starsza wersja) obsługiwały maksymalny rozmiar zdjęcia wynoszący 1600 x 1600 pikseli. Funkcja „Umieszczanie zdjęć” (nowa) obsługuje rozmiary do 4800 x 4800 pikseli.
Zmiana odwołań na zdjęcia
Zdjęcia miejsc (nowa wersja) Interfejs API wymaga podania nazwy zasobu żądanego zdjęcia, która zawiera identyfikator miejsca i odniesienie 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 (nowy), wyszukiwanie tekstowe (nowy) i szczegóły miejsca (nowy) 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 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 musisz przekazać tylko odwodnienie do zdjęcia w formie:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Funkcje Znajdź miejsce (starsza wersja), Wyszukiwanie w pobliżu (starsza wersja), Wyszukiwanie tekstowe (starsza wersja) i Szczegóły miejsca (starsza wersja) zwracają tablicę photos[] w odpowiedzi, która obsługuje ten format. Każdy element photo w starszej odpowiedzi zawiera te pola:
photo_reference– ciąg znaków służący do identyfikowania zdjęcia podczas wykonywania żądania dotyczącego zdjęcia.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.