Zdjęcia miejsca

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Usługa Miejsce zdjęć, część interfejsu Places API, to interfejs tylko do odczytu, który pozwala dodawać do aplikacji wysokiej jakości treści fotograficzne. Usługa Zdjęcie miejsca zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Gdy uzyskasz informacje o danym miejscu za pomocą prośby o dane miejsca, w przypadku odpowiednich zdjęć pojawią się odniesienia do zdjęcia. W odpowiednich przypadkach żądania Znajdź miejsca, Wyszukiwanie w pobliżu i Wyszukiwanie tekstowe zwracają też jedno odwołanie do danego zdjęcia. Dzięki usłudze Zdjęcia możesz uzyskać dostęp do tych zdjęć i zmienić rozmiar zdjęcia, tak aby był optymalny dla Twojej aplikacji.

Prośby o dostęp do zdjęć

Prośba o zdjęcie miejsca to adres URL HTTP o następującej postaci:

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

Niektóre parametry są wymagane do zainicjowania żądania wyszukiwania. Tak jak w przypadku standardu w adresach URL, wszystkie parametry są rozdzielone znakiem ampersand (&). Poniżej znajdziesz listę parametrów i ich możliwe 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.

Optional parameters

  • 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. Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

  • 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.

Generated from the OpenAPI specification. Edit Report bug

Odwołania do zdjęć

Wszystkie żądania do usługi Zdjęcia miejsca muszą zawierać żądanie photoreference i zwracać je w odpowiedzi na żądanie 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 treści fotograficzne.

Uwaga: liczba zwróconych zdjęć zależy od danego żądania.

  • Żądanie Znajdź miejsce, Wyszukiwanie w pobliżu lub Wyszukiwarka tekstu zwraca co najmniej 1 element photo z tablicy.
  • Żądanie informacji o miejscu zwraca maksymalnie 10 elementów photo.

Każdy element photo zawiera te pola:

  • photo_reference – ciąg znaków używany do identyfikowania zdjęć podczas wykonywania żądania ze zdjęć.
  • height – maksymalna wysokość obrazu.
  • width – maksymalna szerokość obrazu.
  • html_attributions[] – zawiera wymagane informacje o pochodzeniu danych. To pole zawsze będzie widoczne, ale może być puste.

Zdjęcia zwracane przez usługę Zdjęcia pochodzą z różnych lokalizacji, w tym od właścicieli firm i ze zdjęć przesłanych przez użytkowników. W większości przypadków tych zdjęć można użyć bez informacji o wykonaniu lub ich podanie będzie wymagane. Jeśli jednak zwrócony element photo zawiera wartość w polu html_attributions, musisz umieścić dodatkową informację o aplikacji w każdym miejscu, w którym wyświetlasz obraz.

Przykład tablicy photos[] znajdziesz poniżej.

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

Przykład zdjęcia miejsca

Przykładowe żądanie znajdziesz poniżej. To żądanie zwróci obraz odniesienia, zmieniając jego rozmiar tak, aby miał maksymalnie 400 pikseli szerokości.

https://maps.googleapis.com/maps/api/place/photo
  ?maxwidth=400
  &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT
  &key=YOUR_API_KEY

Odpowiedź na zdjęcie miejsca

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

Jeśli żądanie przekroczy dostępny limit, serwer zwróci stan HTTP 403 i wyświetli poniższy obraz, aby zasygnalizować przekroczenie limitu:

Obraz powyżej limitu

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

  • 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.