Zdjęcia miejsca

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Place Photo, część interfejsu Places API, to interfejs tylko do odczytu, który umożliwia dodawanie wysokiej jakości treści fotograficznych do aplikacji. Usługa Zdjęcia miejsca zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Gdy uzyskasz informacje o miejscu za pomocą prośby o dane miejsca, w przypadku odpowiednich zdjęć wyświetlą się odwołania do zdjęć. Zapytania dotyczące wyszukiwania miejsc, wyszukiwania w pobliżu i wyszukiwania tekstu zwracają też wyniki dotyczące jednego zdjęcia w razie potrzeby. Usługa zdjęć pozwala uzyskać dostęp do wymienionych zdjęć i zmienić rozmiar zdjęcia w optymalny sposób.

Prośby o dostęp do zdjęć

Żądanie zdjęcia miejsca to adres URL HTTP o następującym formacie:

https://maps.googleapis.com/maps/api/place/photo?parameters

Niektóre parametry są wymagane do zainicjowania żądania wyszukiwania. Tak jak w przypadku standardowego adresu URL, wszystkie parametry są rozdzielone znakiem „&”. 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.

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 and maxwidth properties accept an integer between 1 and 1600.

  • 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 and maxwidth properties accept an integer between 1 and 1600.

Generated from the OpenAPI specification. Edit Report bug

Odwołania do zdjęć

Wszystkie żądania dotyczące usługi Zdjęcia miejsca muszą zawierać błąd photoreference zwrócony w odpowiedzi na żądanie dotyczące funkcji 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 zawartość związaną ze zdjęciami.

Uwaga: liczba zwróconych zdjęć różni się w zależności od żądania.

  • Żądanie Znajdź miejsca, Wyszukiwanie w pobliżu lub Wyszukiwarka tekstu wyświetla na tablicy maksymalnie jeden element photo.
  • Żądanie dotyczące szczegółów miejsca zwróci maksymalnie 10 elementów photo.

Każdy element photo zawiera te pola:

  • photo_reference – ciąg używany do identyfikowania zdjęcia podczas wykonywania żądania zdjęcia.
  • height – maksymalna wysokość obrazu.
  • width – maksymalna szerokość obrazu.
  • html_attributions[] – zawiera wszystkie wymagane atrybucje. To pole zawsze występuje, ale może być puste.

Zdjęcia zwracane przez usługę Zdjęcia pochodzą z różnych lokalizacji, np. od właścicieli firm i zdjęć przesłanych przez użytkowników. W większości przypadków tych zdjęć można użyć bez oznaczenia lub w celu dodania ich jako autora. Jeśli jednak zwrócony element photo zawiera wartość w polu html_attributions, musisz podać dodatkową atrybucję w swojej aplikacji wszędzie tam, gdzie 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 wskazany obraz, którego rozmiar zmieni się na maksymalnie 400 pikseli.

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 pozycjonowane zdjęcie to zdjęcie. 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 wskazać, że limit został przekroczony:

Obraz powyżej limitu

Jeśli serwer nie może zrozumieć żądania, zwraca stan HTTP 400, co oznacza nieprawidłowe żądanie. Najczęstsze przyczyny nieprawidłowych żądań:

  • Przesłane zdjęcie referencyjne nie zostało poprawnie określone.
  • Żądanie nie zawierało parametrów maxwidth ani maxheight.
  • Wartość parametru maxwidth lub maxheight została ustawiona na null.