Method: places.photos.getMedia

Pobierz materiały z zdjęcia 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

Wymagane. Nazwa zasobu multimediów ze zdjęciami 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 zdjęć, na końcu zasobu zdjęcia musisz dodać /media.

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 przeskalowany, aby pasował do mniejszego z tych wymiarów, przy zachowaniu oryginalnego formatu obrazu. Zarówno właściwości maxHeightPx, jak 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.

Trzeba określić co najmniej jedną z wartoś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 będzie mniejszy niż określone wartości, zwrócony zostanie obraz oryginalny. Jeśli obraz jest większy w jednym z wymiarów, zostanie przeskalowany, aby pasował do mniejszego z tych wymiarów, przy zachowaniu oryginalnego formatu obrazu. Zarówno właściwości maxHeightPx, jak 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.

Trzeba określić co najmniej jedną z wartoś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 jest ustawione, pomiń domyślne przekierowanie HTTP i wyrenderuj odpowiedź w formacie tekstowym (na przykład w formacie JSON w przypadku użycia protokołu HTTP). Jeśli nie skonfigurujesz tej zasady, 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órego można użyć do renderowania zdjęcia.