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ęć zapisanych 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ż zwracane jest jedno zdjęcie powiązane z miejscem, jeśli to możliwe. Korzystając z usługi Zdjęcia, możesz uzyskać dostęp do zdjęć, do których odwołują się te elementy, 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ć parametr photo_reference zwrócony 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 „Znajdź miejsce”, „Wyszukiwanie w pobliżu” lub „Wyszukiwanie tekstowe” zwraca w tablicy co najwyżej 1 element photo.
  • Żądanie Szczegóły miejsca zwraca do 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.

```json
...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
   }]
...
```

Przykład zdjęcia miejsca

Poniżej znajdziesz przykładowe żądanie. To żądanie zwraca 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 pomyślne przesłanie żądania Zdjęcie miejsca jest obraz. Typ obrazu zależy od typu przesłanego pierwotnie zdjęcia.

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

Obraz dotyczący przekroczenia limitu

Jeśli serwer nie może zrozumieć Twojego żądania, zwróci kod stanu HTTP 400, który wskazuje na nieprawidłowe żądanie. Najczęstsze przyczyny nieprawidłowego zgłoszenia 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ł. 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.