Zdjęcia miejsca (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Usługa Place Photos (starsza wersja), która jest częścią interfejsu Places API, to interfejs API tylko do odczytu, który umożliwia dodawanie do aplikacji wysokiej jakości treści fotograficznych. Usługa Place Photos (starsza wersja) zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Gdy uzyskasz informacje o miejscu za pomocą żądania Place Details, zostaną zwrócone odwołania do zdjęć powiązanych z danym miejscem. Żądania Find Place (starsza wersja), Wyszukiwanie w pobliżu (starsza wersja) i Wyszukaj tekst (starsza wersja) również zwracają w razie potrzeby pojedyncze odwołanie do zdjęcia danego miejsca. Korzystając z usługi Place Photos (starsza wersja), możesz uzyskać dostęp do zdjęć, do których odwołują się te odwołania, i zmienić ich rozmiar na optymalny dla Twojej aplikacji.

Żądania Place Photos (starsza wersja)

Żądanie Place Photos (starsza wersja) to adres URL HTTP w tej postaci:

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

Aby zainicjować żądanie wyszukiwania, musisz podać określone parametry. Zgodnie ze standardem adresów URL wszystkie parametry są rozdzielane znakiem ampersand (&). Listę parametrów i ich możliwe wartości znajdziesz poniżej.

Wymagane parametry

  • photo_reference

    Identyfikator w postaci ciągu znaków, który jednoznacznie identyfikuje zdjęcie. Odwołania do zdjęć są zwracane w odpowiedzi na żądanie wyszukiwania miejsc lub informacji o miejscu.

  • maxheight lub maxwidth

    maxheight określa maksymalną preferowaną wysokość obrazu w pikselach. Jeśli obraz jest mniejszy niż podane wartości, zostanie zwrócony oryginalny obraz. Jeśli obraz jest większy w którymkolwiek wymiarze, zostanie przeskalowany tak, aby pasował do mniejszego z 2 wymiarów, z zachowaniem oryginalnych proporcji.

    maxwidth określa maksymalną preferowaną szerokość obrazu w pikselach. Jeśli obraz jest mniejszy niż podane wartości, zostanie zwrócony oryginalny obraz. Jeśli obraz jest większy w którymkolwiek wymiarze, zostanie przeskalowany tak, aby pasował do mniejszego z 2 wymiarów, z zachowaniem oryginalnych proporcji.

    Zarówno właściwość maxheight, jak i maxwidth przyjmują liczbę całkowitą z zakresu od 1 do 1600.

    Musisz określić maxheight, maxwidth lub oba te parametry.

Odwołania do zdjęć

Wszystkie żądania Place Photos (starsza wersja) muszą zawierać parametr photo_reference, który jest zwracany w odpowiedzi na żądanie Find Place (starsza wersja), Wyszukiwanie w pobliżu (starsza wersja), Wyszukaj tekst (starsza wersja) lub informacje o miejscu (starsza wersja). Jeśli miejsce ma powiązane treści fotograficzne, odpowiedź na te żądania będzie zawierać pole photos[].

Uwaga: liczba zwracanych zdjęć zależy od żądania.

  • Żądanie Find Place (starsza wersja), Wyszukiwanie w pobliżu (starsza wersja) lub Wyszukaj tekst (starsza wersja) zwraca w tablicy co najwyżej 1 element photo.
  • Żądanie informacji o miejscu (starsza wersja) 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 podczas wysyłania żądania Place Photos (starsza wersja).
  • height – maksymalna wysokość obrazu.
  • width – maksymalna szerokość obrazu.
  • html_attributions[] – zawiera wszystkie wymagane informacje o autorze. To pole będzie zawsze obecne, ale może być puste.

Zdjęcia zwracane przez Place Photos (starsza wersja) pochodzą z różnych źródeł, m.in. od właścicieli firm i użytkowników. W większości przypadków można używać tych zdjęć bez podawania informacji o autorze lub wymagane informacje o autorze są częścią obrazu. Jeśli jednak zwrócony element photo zawiera wartość w polu html_attributions, musisz dodać dodatkowe informacje o autorze w aplikacji wszędzie tam, gdzie wyświetlasz obraz.

.

Ten przykład pokazuje żądanie informacji o miejscu (starsza wersja):

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 Place Photos (starsza wersja)

Poniżej znajdziesz przykładowe żądanie. To żądanie zwraca obraz, do którego się odwołuje, 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ź Place Photos (starsza wersja)

Odpowiedzią na udane żądanie Place Photos (starsza wersja) jest obraz. Typ obrazu zależy od typu pierwotnie przesłanego zdjęcia.

Jeśli żądanie przekracza dostępny limit, serwer zwraca stan HTTP 403 i wyświetla ten obraz, aby poinformować, że limit został przekroczony:

Obraz przekroczenia limitu

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