Zdjęcia miejsca

Wybierz platformę: Android iOS JavaScript Usługa internetowa

Usługa Place Photo, wchodząca w skład interfejsu Places API, to dostępny tylko do odczytu interfejs API, 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óły miejsca”, odpowiednie zdjęcia będą zwracane jako odwołania do zdjęć. Żądania funkcji Znajdź miejsce, Wyszukiwanie w pobliżu i Wyszukiwanie tekstowe zwracają też w stosownych przypadkach pojedynczy plik referencyjny zdjęcia dla każdego miejsca. Za pomocą usługi Zdjęcia możesz uzyskać dostęp do wybranych zdjęć i zmienić rozmiar obrazu na optymalny dla danej aplikacji.

Poproś o zdjęcia

Żądanie dotyczące zdjęcia miejsca to adres URL HTTP w następującej formie:

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

Do zainicjowania żądania wyszukiwania potrzebne są określone parametry. Tak jak w przypadku adresów URL, wszystkie parametry są rozdzielone znakiem „&”. 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.

  • 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 miejsc muszą zawierać pole photo_reference zwracane w odpowiedzi na prośbę dotyczącą funkcji Znajdź miejsce, Wyszukiwanie w pobliżu, Wyszukiwanie tekstowe lub Szczegóły miejsca. Odpowiedź na te żądania będzie zawierać pole photos[], jeśli dane 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 w tablicy maksymalnie jeden element photo.
  • Żądanie szczegółów miejsca zwraca maksymalnie 10 elementów photo.

Każdy element photo zawiera te pola:

  • photo_reference – ciąg znaków używany do identyfikowania zdjęcia, gdy wysyłasz żądanie dotyczące 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. od właścicieli firm i zdjęć przesłanych przez użytkowników. W większości przypadków mogą one zostać wykorzystane bez informacji o ich źródle lub będą zawierać wymagane informacje o ich źródle. Jeśli jednak zwracany element photo zawiera wartość w polu html_attributions, musisz podać dodatkowe informacje o autorze w swojej aplikacji zawsze, gdy wyświetla się obraz.

.

Oto przykład żądania informacji o miejscu:

curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"

Poniżej znajdziesz 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. Żą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=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

Odpowiedź na zdjęcie

Odpowiedź na żądanie zdjęcia miejsca będzie zdjęciem. Typ zdjęcia zależy od typu pierwotnie przesłanego zdjęcia.

Jeśli żądanie przekracza dostępny limit, serwer zwróci stan HTTP 403 i wyświetli obraz poniżej, aby wskazać, że limit został przekroczony:

Obraz ponad limit miejsca

Jeśli serwer nie może rozpoznać żądania, zwraca stan HTTP 400, co oznacza, że żądanie jest nieprawidłowe. 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 ani maxheight.
  • Wartość parametru maxwidth lub maxheight została ustawiona na null.
  • Ważność dokumentu photo_reference wygasła. Jeśli photo_reference straci ważność, poproś o zaktualizowaną wartość photo_reference za pomocą informacji o miejscu, znajdowania miejsca, wyszukiwania w pobliżu lub wyszukiwania tekstowego.