Interfejs Place Photos (starsza wersja), który jest częścią interfejsu Places API, to interfejs API tylko do odczytu, który umożliwia dodawanie do aplikacji wysokiej jakości treści fotograficznych. Usługa Place Photos (starsza wersja) zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Gdy uzyskasz informacje o miejscu za pomocą żądania Place Details, zostaną zwrócone odwołania do zdjęć powiązanych treści fotograficznych. Żądania wysyłane do usług Find Place (starsza wersja), Nearby Search (starsza wersja) i Text Search (starsza wersja) również zwracają 1 odniesienie do zdjęcia na miejsce, jeśli jest to istotne. Korzystając z interfejsu Place Photos (starsza wersja), możesz uzyskać dostęp do zdjęć, do których się odwołujesz, i zmienić rozmiar obrazu na optymalny dla Twojej aplikacji.
Prośby dotyczące Zdjęć miejsca (starsza wersja)
Żądanie Place Photos (starsza wersja) to adres URL HTTP w tym formacie:
https://maps.googleapis.com/maps/api/place/photo?parameters
Aby zainicjować żądanie wyszukiwania, musisz podać określone parametry. Zgodnie ze standardem adresów URL wszystkie parametry są rozdzielane znakiem ampersand (&
). Listę parametrów i ich możliwych wartości znajdziesz poniżej.
Required parameters
photo_reference
A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.
maxheight or maxwidth
maxheight
specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.maxwidth
specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.You must specify either
maxheight
, ormaxwidth
, or both.
Zdjęcia referencyjne
Wszystkie żądania dotyczące interfejsu Place Photos (starsza wersja) muszą zawierać photo_reference
, która jest zwracana w odpowiedzi na żądanie Find Place (starsza wersja), Nearby Search (starsza wersja), Text Search (starsza wersja) lub Place Details (starsza wersja). Odpowiedź na te żądania będzie zawierać pole photos[]
, jeśli miejsce ma powiązane treści fotograficzne.
Uwaga: liczba zwróconych zdjęć zależy od żądania.
- Żądanie Find Place (Legacy), Nearby Search (Legacy) lub Text Search (Legacy) zwraca w tablicy co najwyżej 1 element
photo
. - Żądanie szczegółów miejsca (starsza wersja) zwraca maksymalnie 10 elementów
photo
.
Każdy element photo
zawiera te pola:
photo_reference
– ciąg znaków używany do identyfikowania zdjęcia podczas wysyłania żądania Place Photos (starsza wersja).height
– maksymalna wysokość obrazu.width
– maksymalna szerokość obrazu.html_attributions[]
– zawiera wymagane informacje o autorze. To pole będzie zawsze obecne, ale może być puste.
Zdjęcia zwracane przez interfejs Place Photos (starsza wersja) pochodzą z różnych źródeł, w tym od właścicieli firm i użytkowników. W większości przypadków można ich używać bez podawania atrybucji lub wymagana atrybucja jest częścią obrazu. Jeśli jednak zwrócony element photo
zawiera wartość w polu html_attributions
, musisz dodać dodatkowe informacje o autorze w aplikacji wszędzie tam, gdzie wyświetlasz obraz.
Ten przykład pokazuje żądanie szczegółów miejsca (starsza wersja):
curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"
Poniżej znajdziesz przykład tablicy photos[]
w odpowiedzi.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
}]
...
Przykład Place Photos (starsza wersja)
Przykładowe żądanie znajdziesz poniżej. Ta prośba zwraca obraz, do którego się odwołuje, zmieniając jego rozmiar tak, aby miał maksymalnie 400 pikseli szerokości.
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q &key=YOUR_API_KEY
Odpowiedź dotycząca Zdjęć miejsca (starsza wersja)
Odpowiedzią na udane żądanie dotyczące Zdjęć miejsc (starsza wersja) jest obraz. Typ obrazu zależy od typu pierwotnie przesłanego zdjęcia.
Jeśli żądanie przekracza dostępny limit, serwer zwraca stan HTTP 403 i wyświetla poniższy obraz, aby poinformować, że limit został przekroczony:
Jeśli serwer nie może zrozumieć Twojego żądania, zwraca stan HTTP 400, który wskazuje na nieprawidłowe żądanie. Najczęstsze przyczyny nieprawidłowego żądania to:
- Przesłane odniesienie do zdjęcia zostało nieprawidłowo określone.
- Żądanie nie zawierało parametrów
maxwidth
animaxheight
. - Wartość parametru
maxwidth
lubmaxheight
została ustawiona nanull
. photo_reference
wygasła. Jeśliphoto_reference
wygaśnie, wyślij żądanie do Szczegółów miejsca (starsza wersja), Znajdź miejsce (starsza wersja), Wyszukiwania w pobliżu (starsza wersja) lub Wyszukiwania tekstowego (starsza wersja), aby uzyskać zaktualizowaną wartośćphoto_reference
.