Zdjęcia miejsca (starsza wersja)

Zdjęcia miejsc (wersja starsza) to interfejs API tylko do odczytu, który jest częścią interfejsu Places API. Umożliwia on dodawanie do aplikacji wysokiej jakości treści fotograficznych. Zdjęcia miejsca (starsza wersja) zapewniają dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. 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ń Znajdź miejsce (starsza wersja), Wyszukaj w pobliżu (starsza wersja) i Wyszukaj tekst (starsza wersja) również zwracane jest jedno zdjęcie powiązane z danym miejscem, jeśli jest ono dostępne. Za pomocą funkcji umieszczania zdjęć (starsza wersja) możesz uzyskać dostęp do zdjęć referencyjnych i zmienić rozmiar obrazu na optymalny dla Twojej aplikacji.

Zdjęcia miejsca (starsza wersja)

Żądanie dotyczące umieszczania zdjęć (starsza wersja) to adres URL HTTP o tym formacie:

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

Aby rozpocząć wyszukiwanie, 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.

Odwołania do zdjęć

Wszystkie żądania dotyczące funkcji Zdjęcia miejsc (starsza wersja) muszą zawierać wartość photo_reference, zwracaną w odpowiedzi na żądanie Znajdź miejsce (starsza wersja), Wyszukaj w pobliżu (starsza wersja), Wyszukaj tekst (starsza wersja) lub Szczegóły miejsca (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.

  • Zapytanie dotyczące funkcji Znajdź miejsce (starsza wersja), wyszukiwania w pobliżu (starsza wersja) lub wyszukiwania tekstowego (starsza wersja) zwraca co najwyżej 1 element photo w tablicy.
  • Żądanie Szczegóły miejsca (starsza wersja) 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 umieszczania zdjęć (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 Zdjęcia miejsc (wersja starsza) 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 podawania informacji o źródle lub będą 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 (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 zdjęć miejsca (starsza wersja)

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ź Zdjęcia miejsca (starsza wersja)

Odpowiedź na żądanie umieszczenia zdjęć (starsza wersja) to obraz. Typ obrazu zależy od typu przesłanego pierwotnie zdjęcia.

Jeśli żądanie przekracza dostępny limit, 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ć żądania, zwraca kod stanu HTTP 400, który wskazuje na nieprawidłowe żądanie. Najczęstsze przyczyny nieprawidłowego żądania to: