Zdjęcia miejsca

Wybierz platformę: Android iOS JavaScript Usługa internetowa

Usługa Zdjęcie miejsca, która jest częścią interfejsu Places API, to interfejs tylko do odczytu, który umożliwia dodawanie do aplikacji wysokiej jakości treści fotograficznych. Usługa Zdjęcia Miejsca zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsca. 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ć rozmiar obrazu do optymalnego rozmiaru dla Twojej aplikacji.

Zdjęcia miejsca

Żądanie zdjęcia miejsca to adres URL HTTP o 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 do usługi Zdjęcie miejsca muszą zawierać photo_reference, zwrócone w odpowiedzi na żądanie Znajdź miejsce, Wyszukaj w pobliżu, Wyszukaj tekstem lub Szczegóły miejsca. Odpowiedź na te żądania będzie zawierać pole photos[], jeśli miejsce ma powiązane treści fotograficzne.

Uwaga: liczba zwróconych zdjęć zależy od żądania.

  • Żądanie wyszukiwania miejsca, wyszukiwania w pobliżu lub wyszukiwania tekstowego zwraca maksymalnie 1 element photo w tablicy.
  • Prośba o szczegóły miejsca 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 wszystkie wymagane informacje. 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 można ich używać bez przypisów, ale mogą one zawierać wymagane informacje. Jeśli jednak zwrócony element photo zawiera wartość w polu html_attributions, musisz dodać dodatkowe informacje o źródle w aplikacji w miejscu wyświetlania obrazu.

.

Ten przykład pokazuje żądanie szczegółów miejsca:

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

Poniżej znajdziesz przykładowe żądanie. Ta prośba zwróci obraz, którego dotyczy odwołanie, zmieniając jego rozmiar tak, aby miał maksymalnie 400 pikseli szerokości.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

Odpowiedź na „Place Photo”

Odpowiedzią na żądanie zdjęcia miejsca, które zostało pomyślnie zrealizowane, będzie obraz. Typ obrazu zależy od typu przesłanego pierwotnie zdjęcia.

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

Obraz dotyczący przekroczenia limitu

Jeśli serwer nie może zrozumieć żądania, zwraca kod stanu HTTP 400, który wskazuje na nieprawidłowe żądanie. Najczęstsze przyczyny nieprawidłowego żądania to:

  • Przesłany identyfikator zdjęcia nie został prawidłowo określony.
  • Żądanie nie zawierało parametrów maxwidth ani maxheight.
  • Wartość parametru maxwidth lub maxheight została ustawiona na null.
  • photo_reference wygasło. Jeśli photo_reference wygaśnie, wyślij żądanie do Szczegóły miejsca, Znajdź miejsce, Wyszukiwanie w pobliżu lub Wyszukiwanie tekstowe, aby uzyskać zaktualizowaną wartość photo_reference.