Method: places.photos.getMedia

Pobierz multimedialne zdjęcie za pomocą ciągu znaków 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

Wymagany. Nazwa zasobu z multimediów fotograficznych w formacie: places/{placeId}/photos/{photo_reference}/media.

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

Parametry zapytania

Parametry
maxWidthPx

integer

Opcjonalnie: Określa maksymalną oczekiwaną szerokość obrazu (w pikselach). Jeśli obraz jest mniejszy niż określone wartości, zwrócony zostanie obraz oryginalny. Jeśli obraz jest większy w jednym z wymiarów, zostanie on dostosowany do mniejszego wymiaru, zachowując oryginalny format obrazu. Właściwości maxHeightPx i maxWidthPx akceptują 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 określić co najmniej jedną z tych właściwości: maxHeightPx lub maxWidthPx. Jeśli nie określono ani argumentu maxHeightPx, ani argumentu maxWidthPx, zwrócony zostanie błąd INVALID_ARGUMENT.

maxHeightPx

integer

Opcjonalnie: Określa maksymalną wysokość obrazu (w pikselach). Jeśli obraz jest mniejszy niż określone wartości, zwrócony zostanie obraz oryginalny. Jeśli obraz jest większy w jednym z wymiarów, zostanie on dostosowany do mniejszego wymiaru, zachowując oryginalny format obrazu. Właściwości maxHeightPx i maxWidthPx akceptują 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 określić co najmniej jedną z tych właściwości: maxHeightPx lub maxWidthPx. Jeśli nie określono ani argumentu maxHeightPx, ani argumentu maxWidthPx, zwrócony zostanie błąd INVALID_ARGUMENT.

skipHttpRedirect

boolean

Opcjonalnie: Jeśli to ustawienie jest ustawione, pomiń domyślne zachowanie przekierowania HTTP i wyświetlaj odpowiedź w formacie tekstowym (np. w formacie JSON w przypadku HTTP). Jeśli nie zostanie ustawiony, zostanie wydane przekierowanie HTTP, aby przekierować wywołanie do multimediów z obrazem. Ta opcja jest ignorowana w przypadku żądań innych niż HTTP.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Media 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 z multimediów fotograficznych w formacie: places/{placeId}/photos/{photo_reference}/media.

photoUri

string

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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