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. Po uzyskaniu informacji o miejscu za pomocą aplikacji Miejsce Prośba o szczegóły; odniesienia do zdjęć zostaną zwrócone w przypadku odpowiednich zdjęć treści. Żądania wyszukiwania miejsca, wyszukiwania w pobliżu i wyszukiwania tekstowego również zwracają jedno zdjęcie odniesienie do miejsca w odpowiednich przypadkach. Korzystając z usługi Zdjęcia, możesz wtedy uzyskać dostęp do wskazane zdjęcia i zmień rozmiar obrazu na optymalny 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. Tak jak w standardzie w adresach URL wszystkie parametry są rozdzielone znakiem „&”. 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.

  • 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ć 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 klucz 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, gdy i wysyłania prośby o zdjęcia.
  • height – maksymalna wysokość obrazu;
  • width – maksymalna szerokość obrazu.
  • html_attributions[] – zawiera wymagane atrybucje. Ten pole zawsze będzie obecne, ale może być puste.

Zdjęcia zwracane przez usługę Zdjęcia pochodzą z różnych lokalizacji, w tym właścicieli firm i zdjęć przesłanych przez 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

Przykładowe żądanie znajdziesz poniżej. To żądanie zwróci określone obrazu, zmieniając rozmiar, tak aby 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. Typ obraz zależy od typu pierwotnie przesłanego zdjęcia.

Jeśli żądanie przekracza dostępny limit, serwer zwróci błąd HTTP 403 i wyświetl poniższy obraz, aby zasygnalizować, że limit przekroczono limit:

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.: