Zdjęcia miejsca (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Place Photos (starsza wersja), część Places API, to interfejs API tylko do odczytu, który umożliwia dodawanie do aplikacji wysokiej jakości treści fotograficznych. Zdjęcia miejsc (starsza wersja) dają dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Gdy pobierasz informacje o miejscu za pomocą żądania szczegółów miejsca, w przypadku odpowiednich treści fotograficznych zwracane są odwołania do zdjęć. Żądania wyszukiwania miejsca (starsza wersja), wyszukiwania w pobliżu (starsza wersja) i wyszukiwania tekstu (starsza wersja) również zwracają 1 referencję do zdjęcia na miejsce, jeśli jest to możliwe. Korzystając z usługi Place Photos (starsza wersja), możesz uzyskać dostęp do zdjęć, do których odwołują się te identyfikatory, i zmienić ich rozmiar na optymalny dla Twojej aplikacji.

Żądania Place Photos (starsza wersja)

Żądanie Place Photos (starsza wersja) to adres URL HTTP w tym formacie:

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 (&). Poniżej znajdziesz listę parametrów i ich możliwych wartości.

Wymagane parametry

photo_reference

Identyfikator 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 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, zostanie zwrócony oryginalny obraz. Jeśli obraz jest większy w którymkolwiek wymiarze, zostanie przeskalowany do mniejszego z tych 2 wymiarów, z zachowaniem oryginalnego formatu obrazu.

Właściwości maxheight i maxwidth akceptują liczbę całkowitą z zakresu od 1 do 1600.

Musisz podać maxheight lub maxwidth albo obie te wartości.

Odniesienia do zdjęć

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

  • Żądanie wyszukiwania miejsca (starsza wersja), wyszukiwania w pobliżu (starsza wersja) lub wyszukiwania tekstowego (starsza wersja) zwraca w tablicy maksymalnie 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 identyfikacji 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 Place Photos (Legacy) 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 informacji o autorze lub wymagane informacje są już częścią obrazu. Jeśli jednak zwrócony element photo zawiera wartość w polu html_attributions, musisz dodać w aplikacji dodatkowe informacje o autorze wszędzie tam, gdzie wyświetlasz obraz.

Poniższy 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 (Legacy)

Poniżej znajdziesz przykładowe żądanie. To żądanie zwraca obraz referencyjny, 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)

Odpowiedź na udane żądanie Place Photos (starsza wersja) to 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 dotyczący przekroczenia limitu

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