Zdjęcia miejsca

Wybierz platformę: Android iOS JavaScript Usługa internetowa

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

    You must specify either maxheight, or maxwidth, 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:

Obraz przekroczenia 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 ani maxheight.
  • Wartość parametru maxwidth lub maxheight została ustawiona na null.
  • Nagroda photo_reference wygasła. Jeśli parametr photo_reference wygaśnie, poproś o szczegóły miejsca, Znajdź miejsce, wyszukiwanie w pobliżu lub wyszukiwanie tekstowe, aby uzyskać zaktualizowaną wartość photo_reference.