Zdjęcia miejsca (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Place Photos (starsza wersja), część 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 (Legacy) 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 odpowiednimi treściami fotograficznymi. Żądania wysyłane do usług Find Place (starsza wersja), Wyszukiwanie w pobliżu (starsza wersja) i Wyszukaj tekst (starsza wersja) również zwracają 1 odniesienie do zdjęcia na miejsce, jeśli jest to odpowiednie. Korzystając z usługi Zdjęcia miejsc (starsza wersja), możesz uzyskać dostęp do zdjęć, do których się odwołujesz, i zmienić rozmiar obrazu na optymalny dla Twojej aplikacji.

Żądania Place Photos (starsza wersja)

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

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

Do zainicjowania żądania wyszukiwania wymagane są określone parametry. Zgodnie ze standardem adresów URL wszystkie parametry są oddzielone znakiem ampersand (&). Listę parametrów i ich możliwych 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 żądanie informacji o miejscu.

  • maxheight lub maxwidth

    maxheight określa maksymalną preferowaną wysokość obrazu w pikselach. Jeśli obraz jest mniejszy niż określone wartości, zostanie zwrócony oryginalny obraz. Jeśli obraz jest większy w jednym z wymiarów, zostanie przeskalowany do mniejszego z tych 2 wymiarów, z zachowaniem oryginalnego formatu obrazu.

    maxwidth określa maksymalną preferowaną szerokość obrazu w pikselach. Jeśli obraz jest mniejszy niż podane wartości, zwracany jest oryginalny obraz. Jeśli obraz jest większy w jednym z wymiarów, zostanie przeskalowany tak, aby pasował do mniejszego z nich, z zachowaniem pierwotnego współczynnika proporcji.

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

    Musisz podać maxheight lub maxwidth albo oba te atrybuty.

Zdjęcia referencyjne

Wszystkie żądania wysyłane do usługi Place Photos (starsza wersja) muszą zawierać photo_reference, zwrócony w odpowiedzi na żądanie Find Place (starsza wersja), Wyszukiwanie w pobliżu (starsza wersja), Wyszukaj tekst (starsza wersja) lub informacje o miejscu (starsza wersja). 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 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 szczegółów miejsca (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 wymagane informacje o autorze. To pole będzie zawsze obecne, ale może być puste.

Zdjęcia zwracane przez interfejs Place Photos (starsza wersja) pochodzą z różnych lokalizacji, w tym od właścicieli firm i użytkowników. W większości przypadków można ich używać bez podawania atrybucji lub wymagana atrybucja jest częścią obrazu. Jeśli jednak zwrócony element photo zawiera wartość w polu html_attributions, musisz dołączyć 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)

Przykładowe żądanie znajdziesz poniżej. 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 dotyczące Zdjęć miejsc (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 poniższy obraz, aby wskazać, że limit został przekroczony:

Obraz przekroczenia limitu

Jeśli serwer nie może zrozumieć żądania, zwraca stan HTTP 400, który wskazuje nieprawidłowe żądanie. Najczęstsze przyczyny nieprawidłowych żądań to: