Zdjęcia miejsca

Wybierz platformę: Android iOS JavaScript Usługa internetowa

Usługa Place Photo, będąca częścią interfejsu Places API, to Jedyny interfejs API, który pozwala dodawać do aplikacji. Usługa Zdjęcia Miejsc zapewnia dostęp do milionów zdjęć przechowywane w bazie danych Miejsc. Gdy pobierasz informacje o miejscu za pomocą żądania Szczegóły miejsca, zwracane są odniesienia do zdjęć związanych z odpowiednim materiałem fotograficznym. W przypadku żądań wyszukiwania miejsca, wyszukiwania w pobliżu i wyszukiwania tekstowego również zwracana jest jedna referencja do zdjęcia dla danego miejsca (jeśli jest to możliwe). Za pomocą usługi Zdjęcia możesz uzyskać dostęp do zdjęć, do których odwołują się odwołania, i zmienić ich rozmiar do optymalnego dla Twojej 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

Aby rozpocząć żądanie wyszukiwania, musisz podać określone parametry. Zgodnie ze standardem w adresach URL wszystkie parametry są rozdzielane 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.

Odnośniki do zdjęć

Wszystkie żądania wysyłane do usługi Zdjęcia miejsca muszą zawierać atrybuty photo_reference, zwracane w odpowiedzi na wyszukiwanie miejsca, wyszukiwanie w pobliżu, wyszukiwanie tekstowe lub informacje o miejscu użytkownika. 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 wyszukiwania miejsca, wyszukiwania w pobliżu lub wyszukiwania tekstowego 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 znaków służący do identyfikowania zdjęcia podczas wykonywania żądania dotyczącego zdjęcia.
  • height – maksymalna wysokość obrazu;
  • width – maksymalna szerokość obrazu.
  • html_attributions[] – zawiera wymagane atrybucje. To pole będzie zawsze obecne, ale może być puste.

Zdjęcia z usługi Zdjęcia pochodzą z różnych źródeł, w tym od właścicieli firm i użytkowników. W większości przypadków mogą zostać wykorzystane bez informacji o autorze lub będą miały wymagane informacje o autorze który jest częścią zdjęcia. Jeśli jednak zwrócony element photo zawiera wartość w polu html_attributions, musisz też dodać dodatkowe źródło informacji w aplikacji, niezależnie od miejsca, w którym jest ona wyświetlana.

.

Żą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

Poniżej znajdziesz przykładowe żądanie. Ta prośba zwróci obraz, którego dotyczy odwołanie, zmieniając jego rozmiar tak, aby jego szerokość wynosiła maksymalnie 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 miejsca”

Odpowiedź na żądanie dotyczące zdjęcia miejsca otrzyma obraz. Typ obraz zależy od typu pierwotnie przesłanego zdjęcia.

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

Obraz przekroczenia limitu

Jeśli serwer nie zrozumie Twojego żądania, zwraca kod HTTP 400. co oznacza nieprawidłowe żądanie. Najczęstsze przyczyny nieprawidłowe żądanie to m.in.: