Usługa Place Photo, będąca częścią interfejsu Places API, to interfejs API tylko do odczytu, który pozwala dodawać do aplikacji wysokiej jakości treści fotograficzne. Usługa Zdjęcia Miejsc zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Gdy uzyskasz informacje o miejscu za pomocą żądania informacji o miejscu, w przypadku odpowiednich treści fotograficznych zwrócone zostaną referencyjne zdjęcia. Żądania funkcji Znajdź miejsce, Wyszukiwanie w pobliżu i Wyszukiwanie tekstowe również w razie potrzeby zwracają pojedyncze odwołanie do zdjęcia dla danego miejsca. Za pomocą usługi Zdjęcia możesz uzyskać dostęp do wybranych zdjęć i zmienić rozmiar obrazu na optymalny dla danej aplikacji.
Wysyłanie próśb o zdjęcia
Żądanie zdjęcia miejsca to URL HTTP w tym formacie:
https://maps.googleapis.com/maps/api/place/photo?parameters
Do zainicjowania żądania wyszukiwania wymagane są określone parametry. Zgodnie ze standardem w adresach URL wszystkie parametry są oddzielane znakiem ampersand (&
). Poniżej znajdziesz listę parametrów i ich możliwych wartości.
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.
Odniesienia do zdjęć
Wszystkie żądania wysyłane do usługi Zdjęcia miejsca muszą zawierać obiekt photo_reference
zwrócony w odpowiedzi na zapytanie Znajdź miejsce, Wyszukiwanie w pobliżu, Wyszukiwanie tekstowe lub Informacje o miejscu. Odpowiedź na te żądania będzie zawierać pole photos[]
, jeśli miejsce ma powiązane treści fotograficzne.
Uwaga: liczba zwróconych zdjęć różni się w zależności od prośby.
- Żądanie Znajdź miejsce, Wyszukiwanie w pobliżu lub Wyszukiwanie tekstowe zwraca maksymalnie 1 element
photo
w tablicy. - Żądanie dotyczące informacji o miejscu zwraca maksymalnie 10 elementów
photo
.
Każdy element photo
zawiera te pola:
photo_reference
– ciąg tekstowy służący do rozpoznawania zdjęcia podczas wykonywania żądania zdjęcia.height
– maksymalna wysokość obrazu;width
– maksymalna szerokość obrazu.html_attributions[]
– zawiera wymagane atrybucje. To pole będzie zawsze dostępne, ale może być puste.
Zdjęcia zwracane przez usługę Zdjęcia pochodzą z różnych lokalizacji, między innymi od właścicieli firm i użytkowników. W większości przypadków zdjęcia te mogą zostać wykorzystane bez informacji o autorze lub zawierają wymagane informacje o autorze, które są częścią zdjęcia. Jeśli jednak zwrócony element photo
zawiera wartość w polu html_attributions
, podczas wyświetlania obrazu musisz uwzględnić w aplikacji dodatkową atrybucję.
Żądanie dotyczące informacji o miejscu zawiera ten przykład:
curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"
Poniżej znajduje się przykład tablicy photos[]
w odpowiedzi.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
}
...
Przykład zdjęcia miejsca
Przykładowe żądanie znajdziesz poniżej. To żądanie zwróci wskazany obraz, a jego rozmiar zmieni się tak, żeby miał szerokość maksymalnie 400 pikseli.
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q &key=YOUR_API_KEY
Wyślij odpowiedź ze zdjęciem
Odpowiedź na żądanie dotyczące zdjęcia miejsca otrzyma obraz. Rodzaj zdjęcia zależy od typu pierwotnie przesłanego zdjęcia.
Jeśli żądanie przekroczy dostępny limit, serwer zwróci stan HTTP 403 i wyświetli poniższy obraz, aby zasygnalizować przekroczenie limitu:
Jeśli serwer nie zrozumie Twojego żądania, zwraca stan HTTP 400, co oznacza nieprawidłowe żądanie. Oto najczęstsze przyczyny nieprawidłowego żądania:
- Przesłane odwołanie 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
. - Nagroda
photo_reference
wygasła. Jeśli parametrphoto_reference
wygaśnie, poproś o szczegóły miejsca, Znajdź miejsce, wyszukiwanie w pobliżu lub wyszukiwanie tekstowe, aby uzyskać zaktualizowaną wartośćphoto_reference
.