Zdjęcia miejsca

Wybierz platformę: Android iOS JavaScript Usługa internetowa

Usługa Place Photo, część interfejsu Places API, to interfejs API dostępny tylko do odczytu, który umożliwia dodawanie do aplikacji wysokiej jakości zdjęć. Usługa Zdjęcia miejsc zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Gdy uzyskasz informacje o miejscu za pomocą żądania szczegółów miejsca, zostaną zwrócone odniesienia do zdjęć dla odpowiednich zdjęć. W stosownych przypadkach żądania funkcji Wyszukiwanie miejsc, Wyszukiwanie w pobliżu i Wyszukiwanie tekstowe zwracają też w stosownych przypadkach pojedyncze odwołanie do zdjęcia dla każdego miejsca. Za pomocą usługi Zdjęcia możesz uzyskać dostęp do zdjęć, do których istnieją odwołania, i zmienić rozmiar obrazu na taki, którego rozmiar jest optymalny dla Twojej aplikacji.

Poproś o zrobienie zdjęcia

Żądanie zdjęcia miejsca to adres URL HTTP o następującej postaci:

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

Do uruchomienia żądania wyszukiwania niezbędne są określone parametry. Tak jak w przypadku adresów URL, wszystkie parametry są rozdzielone znakiem „&”. Poniżej znajduje się lista parametrów i 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.

Odniesienia do zdjęć

Wszystkie żądania wysyłane do usługi Zdjęcia miejsc muszą zawierać pole photo_reference zwracane w odpowiedzi na żądania Znajdź miejsce, Wyszukiwanie w pobliżu, Wyszukiwanie tekstowe lub Szczegóły miejsca. Odpowiedź na te żądania będzie zawierać pole photos[], jeśli miejsce ma powiązane materiały fotograficzne.

Uwaga: liczba zwróconych zdjęć różni się w zależności od prośby.

  • Żądanie Znajdź miejsce, Wyszukiwanie w pobliżu lub Wyszukiwanie tekstowe zwraca maksymalnie jeden element photo w tablicy.
  • Żądanie szczegółów miejsca zwraca maksymalnie 10 elementów photo.

Każdy element photo będzie zawierać te pola:

  • photo_reference – ciąg znaków używany do identyfikowania zdjęcia podczas wysyłania żądania zdjęcia.
  • height – maksymalna wysokość obrazu,
  • width – maksymalna szerokość obrazu;
  • html_attributions[] – zawiera wszystkie wymagane atrybucje, To pole zawsze będzie obecne, ale może być puste.

Zdjęcia zwracane przez usługę Zdjęcia pochodzą z różnych lokalizacji, m.in. przez właścicieli firm i zdjęcia przesłane przez użytkowników. W większości przypadków te zdjęcia mogą zostać wykorzystane bez informacji o ich źródle lub będą musiały zawierać wymagane informacje o ich źródle. Jeśli jednak zwrócony element photo zawiera wartość w polu html_attributions, musisz uwzględnić dodatkowe informacje o autorze w aplikacji wszędzie tam, gdzie wyświetlasz obraz.

Poniżej znajdziesz przykład tablicy photos[].

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1"
   }
...

Przykład zdjęcia miejsca

Poniżej znajdziesz przykładowe żądanie. To żądanie zwróci wskazany obraz, zmieniając jego rozmiar tak, aby jego szerokość nie przekraczała 400 pikseli.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1&key=YOUR_API_KEY

Odpowiedź na zdjęcie

Odpowiedź na żądanie zdjęcia miejsca jest zdjęciem. Typ zdjęcia zależy od typu oryginalnie przesłanego zdjęcia.

Jeśli żądanie przekracza dostępny limit, serwer zwróci stan HTTP 403 i wyświetli poniższy obraz, który wskazuje, że limit został przekroczony:

Obraz Over Quota

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

  • Przesłane odwołanie do zdjęcia nie zostało poprawnie określone.
  • Żądanie nie zawierało parametrów maxwidth ani maxheight.
  • Wartość parametru maxwidth lub maxheight została ustawiona na null.