Usługa Miejsce zdjęć, część interfejsu Places API, to interfejs tylko do odczytu, który pozwala dodawać do aplikacji wysokiej jakości treści fotograficzne. Usługa Zdjęcie miejsca zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Gdy uzyskasz informacje o danym miejscu za pomocą prośby o dane miejsca, w przypadku odpowiednich zdjęć pojawią się odniesienia do zdjęcia. W odpowiednich przypadkach żądania Znajdź miejsca, Wyszukiwanie w pobliżu i Wyszukiwanie tekstowe zwracają też jedno odwołanie do danego zdjęcia. Dzięki usłudze Zdjęcia możesz uzyskać dostęp do tych zdjęć i zmienić rozmiar zdjęcia, tak aby był optymalny dla Twojej aplikacji.
Prośby o dostęp do zdjęć
Prośba o zdjęcie miejsca to adres URL HTTP o następującej postaci:
https://maps.googleapis.com/maps/api/place/photo?parameters
Niektóre parametry są wymagane do zainicjowania żądania wyszukiwania. Tak jak w przypadku standardu w adresach URL, wszystkie parametry są rozdzielone znakiem ampersand (&
). Poniżej znajdziesz listę parametrów i ich możliwe 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.
Optional parameters
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. Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.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
.
Generated from the OpenAPI specification. Edit Report bug
Odwołania do zdjęć
Wszystkie żądania do usługi Zdjęcia miejsca muszą zawierać żądanie photoreference
i zwracać je w odpowiedzi na żądanie 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 treści fotograficzne.
Uwaga: liczba zwróconych zdjęć zależy od danego żądania.
- Żądanie Znajdź miejsce, Wyszukiwanie w pobliżu lub Wyszukiwarka tekstu zwraca co najmniej 1 element
photo
z tablicy. - Żądanie informacji o miejscu zwraca maksymalnie 10 elementów
photo
.
Każdy element photo
zawiera te pola:
photo_reference
– ciąg znaków używany do identyfikowania zdjęć podczas wykonywania żądania ze zdjęć.height
– maksymalna wysokość obrazu.width
– maksymalna szerokość obrazu.html_attributions[]
– zawiera wymagane informacje o pochodzeniu danych. To pole zawsze będzie widoczne, ale może być puste.
Zdjęcia zwracane przez usługę Zdjęcia pochodzą z różnych lokalizacji, w tym od właścicieli firm i ze zdjęć przesłanych przez użytkowników. W większości przypadków tych zdjęć można użyć bez informacji o wykonaniu lub ich podanie będzie wymagane. Jeśli jednak zwrócony element photo
zawiera wartość w polu html_attributions
, musisz umieścić dodatkową informację o aplikacji w każdym miejscu, w którym wyświetlasz obraz.
Przykład tablicy photos[]
znajdziesz poniżej.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
}
...
Przykład zdjęcia miejsca
Przykładowe żądanie znajdziesz poniżej. To żądanie zwróci obraz odniesienia, zmieniając jego rozmiar tak, aby miał maksymalnie 400 pikseli szerokości.
https://maps.googleapis.com/maps/api/place/photo ?maxwidth=400 &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT &key=YOUR_API_KEY
Odpowiedź na zdjęcie miejsca
Odpowiedź na udane żądanie zdjęcia miejsca jest obrazem. Typ zdjęcia zależy od typu przesłanego pierwotnie 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 może zrozumieć żądania, zwraca stan HTTP 400, który wskazuje na nieprawidłowe żądanie. Najczęstsze przyczyny nieprawidłowych żądań:
- 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
.