Usługa Place Photo, część interfejsu Places API, to interfejs API dostępny tylko do odczytu, który umożliwia dodawanie do aplikacji wysokiej jakości zdjęć. 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 szczegółów miejsca, zostaną zwrócone odniesienia do zdjęć dla odpowiednich zdjęć. W stosownych przypadkach żądania funkcji Wyszukiwanie miejsc, Wyszukiwanie w pobliżu i Wyszukiwanie tekstowe zwracają też w stosownych przypadkach pojedyncze odwołanie do zdjęcia dla każdego miejsca. Za pomocą usługi Zdjęcia możesz uzyskać dostęp do zdjęć, do których istnieją odwołania, i zmienić rozmiar obrazu na taki, którego rozmiar jest optymalny dla Twojej aplikacji.
Poproś o zrobienie zdjęcia
Żądanie zdjęcia miejsca to adres URL HTTP o następującej postaci:
https://maps.googleapis.com/maps/api/place/photo?parameters
Do uruchomienia żądania wyszukiwania niezbędne są określone parametry. Tak jak w przypadku adresów URL, wszystkie parametry są rozdzielone znakiem „&
”. Poniżej znajduje się lista parametrów i 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 miejsc muszą zawierać pole photo_reference
zwracane w odpowiedzi na żądania Znajdź miejsce, Wyszukiwanie w pobliżu, Wyszukiwanie tekstowe lub Szczegóły miejsca. Odpowiedź na te żądania będzie zawierać pole photos[]
, jeśli miejsce ma powiązane materiały 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 jeden element
photo
w tablicy. - Żądanie szczegółów miejsca zwraca maksymalnie 10 elementów
photo
.
Każdy element photo
będzie zawierać te pola:
photo_reference
– ciąg znaków używany do identyfikowania zdjęcia podczas wysyłania żądania zdjęcia.height
– maksymalna wysokość obrazu,width
– maksymalna szerokość obrazu;html_attributions[]
– zawiera wszystkie wymagane atrybucje, To pole zawsze będzie obecne, ale może być puste.
Zdjęcia zwracane przez usługę Zdjęcia pochodzą z różnych lokalizacji, m.in. przez właścicieli firm i zdjęcia przesłane przez użytkowników. W większości przypadków te zdjęcia mogą zostać wykorzystane bez informacji o ich źródle lub będą musiały zawierać wymagane informacje o ich źródle. Jeśli jednak zwrócony element photo
zawiera wartość w polu html_attributions
, musisz uwzględnić dodatkowe informacje o autorze w aplikacji wszędzie tam, gdzie wyświetlasz obraz.
Poniżej znajdziesz przykład tablicy photos[]
.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1"
}
...
Przykład zdjęcia miejsca
Poniżej znajdziesz przykładowe żądanie. To żądanie zwróci wskazany obraz, zmieniając jego rozmiar tak, aby jego szerokość nie przekraczała 400 pikseli.
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1 &key=YOUR_API_KEY
Odpowiedź na zdjęcie
Odpowiedź na żądanie zdjęcia miejsca jest zdjęciem. Typ zdjęcia zależy od typu oryginalnie przesłanego zdjęcia.
Jeśli żądanie przekracza dostępny limit, serwer zwróci stan HTTP 403 i wyświetli poniższy obraz, który wskazuje, że limit został przekroczony:
Jeśli serwer nie może zrozumieć żądania, zwraca stan HTTP 400, który wskazuje na nieprawidłowe żądanie. Najczęstsze przyczyny nieprawidłowego żądania:
- Przesłane odwołanie do zdjęcia nie zostało poprawnie określone.
- Żądanie nie zawierało parametrów
maxwidth
animaxheight
. - Wartość parametru
maxwidth
lubmaxheight
została ustawiona nanull
.