Method: places.photos.getMedia

Pobierz plik multimedialny ze zdjęciem za pomocą ciągu odniesienia do zdjęcia.

Żądanie HTTP

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. Nazwa zasobu multimediów ze zdjęciem w formacie: places/{placeId}/photos/{photo_reference}/media.

Nazwa zasobu zdjęcia zwracana w polu photos.name obiektu Place ma format places/{placeId}/photos/{photo_reference}. Aby uzyskać nazwę zasobu multimediów zdjęcia, musisz dodać /media na końcu zasobu zdjęcia.

Parametry zapytania

Parametry
maxWidthPx

integer

Opcjonalnie. Określa maksymalną żądaną 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. Właściwości maxHeightPx i maxWidthPx przyjmują liczbę całkowitą z zakresu od 1 do 4800 włącznie. Jeśli wartość nie mieści się w dozwolonym zakresie, zwracany jest błąd INVALID_ARGUMENT.

Musisz podać co najmniej jedną z wartości maxHeightPx lub maxWidthPx. Jeśli nie podano ani maxHeightPx, ani maxWidthPx, zwracany jest błąd INVALID_ARGUMENT.
maxHeightPx

integer

Opcjonalnie. Określa maksymalną oczekiwaną wysokość 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. Właściwości maxHeightPx i maxWidthPx przyjmują liczbę całkowitą z zakresu od 1 do 4800 włącznie. Jeśli wartość nie mieści się w dozwolonym zakresie, zwracany jest błąd INVALID_ARGUMENT.

Musisz podać co najmniej jedną z wartości maxHeightPx lub maxWidthPx. Jeśli nie podano ani maxHeightPx, ani maxWidthPx, zwracany jest błąd INVALID_ARGUMENT.
skipHttpRedirect

boolean

Opcjonalnie. Jeśli ta opcja jest ustawiona, pomiń domyślne przekierowanie HTTP i wyrenderuj odpowiedź w formacie tekstowym (np. w formacie JSON w przypadku HTTP). Jeśli nie jest ustawiony, zostanie wydane przekierowanie HTTP, aby przekierować połączenie do multimediów z obrazem. Ta opcja jest ignorowana w przypadku żądań innych niż HTTP.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Plik multimedialny ze zdjęciem z interfejsu Places API.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "name": string,
  "photoUri": string
}
Pola
name

string

Nazwa zasobu multimediów ze zdjęciem w formacie: places/{placeId}/photos/{photo_reference}/media.
photoUri

string

Krótkotrwały identyfikator URI, którego można użyć do renderowania zdjęcia.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/maps-platform.places.getphotomedia
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform