Zdjęcie miejsca (nowość) to interfejs API tylko do odczytu, który pozwala dodawać wysokiej jakości zdjęć do aplikacji. Usługa Place Photo daje dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc.
Po otrzymaniu informacji o miejscu za pomocą żądania Szczegóły miejsca, wyszukiwania w pobliżu lub wyszukiwania tekstowego, można również poprosić o zasoby fotograficzne dotyczące odpowiednich treści fotograficznych. Przy użyciu usługi Zdjęcia uzyskasz dostęp do tych zdjęć i dostosujesz rozmiar obrazu do optymalnego aplikacji.
API Explorer umożliwia wysyłanie żądań na żywo, dzięki czemu możesz zapoznać się z interfejsem API Opcje interfejsu API:
WypróbujWysyłanie próśb o zdjęcia
Żądanie zdjęcia miejsca to żądanie HTTP GET do adresu URL w postaci:https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS
Gdy wymagane są te parametry:
- NAME zawiera nazwę zasobu zdjęcia.
- API_KEY zawiera klucz interfejsu API.
- Pole PARAMETERS zawiera parametr
maxHeightPx
, parametrmaxWidthPx
lub oba te elementy.
Poniżej znajdziesz pełną listę wymaganych i opcjonalnych parametrów.
Wymagane parametry
Nazwa zdjęcia
Identyfikator w postaci ciągu znaków, który jednoznacznie identyfikuje zdjęcie. Nazwy zdjęć są zwracane z
Szczegóły miejsca (nowość), Wyszukiwanie w pobliżu (nowość),
lub zapytanie tekstowe (nowe)
we właściwości name
każdego elementu tablicy photos[]
.
Przykład znajdziesz w sekcji Uzyskiwanie nazwy zdjęcia.
maxHeightPx i maxWidthPx
Określa maksymalną wysokość i szerokość obrazu (w pikselach). Jeśli obraz jest mniejszy niż podane wartości, zwrócony zostanie obraz oryginalny. Jeśli obraz jest większy w , zostanie on przeskalowany tak, aby dopasować go do mniejszego z tych 2 wymiarów, ograniczony do pierwotnego format obrazu. Właściwości maxheight i maxwidth akceptują liczbę całkowitą z zakresu od 1 do 4800.
Musisz określić maxHeightPx
, maxWidthPx
lub obie.
Parametry opcjonalne
skipHttpRedirect
Jeśli false
(domyślnie), wykonaj przekierowanie HTTP do obrazu, aby go zwrócić.
Jeśli true
, pomiń przekierowanie i zwróć odpowiedź JSON ze szczegółami obrazu.
Na przykład:
{ "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media", "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" }
Ta opcja jest ignorowana w przypadku żądań innych niż HTTP.
Uzyskaj nazwę zdjęcia
Wszystkie żądania wysyłane do usługi Zdjęcia miejsca muszą zawierać
nazwa zasobu zdjęcia zwracana w odpowiedzi na wyszukiwanie w pobliżu, wyszukiwanie tekstowe lub
Prośba o szczegóły. Odpowiedź na te żądania zawiera tablicę photos[]
, jeśli
ma powiązane treści fotograficzne.
Każdy element photo[]
zawiera te pola:
name
– ciąg tekstowy zawierający nazwę zasobu zdjęcia, gdy i wysyłania prośby o zdjęcia. Ma on format:places/PLACE_ID/photos/PHOTO_RESOURCE
heightPx
– maksymalna wysokość obrazu w pikselach.widthPx
– maksymalna szerokość obrazu w pikselach.authorAttributions[]
– wszelkie wymagane atrybucje. Ten pole jest zawsze obecne, ale może być puste.
Zdjęcia zwracane przez usługę Zdjęcia pochodzą z różnych lokalizacji,
w tym właścicieli firm
i zdjęć przesłanych przez użytkowników. W większości przypadków
mogą zostać wykorzystane bez informacji o autorze lub będą miały wymagane informacje o autorze
który jest częścią zdjęcia. Jeśli jednak zwrócony element photo
zawiera wartość w polu authorAttributions
, musisz też dodać
dodatkowe źródło informacji w aplikacji, niezależnie od miejsca, w którym jest ona wyświetlana.
Poniższy przykład to żądanie informacji o miejscu, które zawiera photos
w
maską pola, by odpowiedź zawierała tablicę photos[]
:
curl -X GET \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,photos" \ https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E
photos[]
w odpowiedzi.
... "photos" : [ { "name": "places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1", "widthPx": 6000, "heightPx": 4000, "authorAttributions": [ { "displayName": "John Smith", "uri": "//maps.google.com/maps/contrib/101563", "photoUri": "//lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" } ] }, ...
Prośba o zdjęcie miejsca
Przykładowe żądanie poniżej zwraca obraz za pomocą zasobu name
i zmienia jego rozmiar
że ma maksymalnie 400 pikseli wysokości i szerokości:
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY
Odpowiedź. żądania zdjęcia miejsca to obraz. Typ zdjęcia zależy od typu pierwotnie przesłanego zdjęcia.
Jeśli żądanie przekracza dostępny limit, serwer zwróci błąd HTTP 403 i wyświetl poniższy obraz, aby zasygnalizować, że limit przekroczono limit:
![Obraz przekroczenia limitu](https://developers.google.cn/static/maps/documentation/maps-static/images/quota.png?authuser=9&hl=pl)
Jeśli serwer nie zrozumie Twojego żądania, zwraca kod HTTP 400. co oznacza nieprawidłowe żądanie. Najczęstsze przyczyny nieprawidłowe żądanie to m.in.:
- Podana nazwa zdjęcia jest nieprawidłowa.
- Żądanie nie zawierało tych pól:
maxHeightPx
animaxWidthPx
. - Ustawiono wartość parametru
maxHeightPx
lubmaxWidthtPx
. do:null
. - Nagroda
name
wygasła. Jeśliname
wygaśnie, utwórz prośba o Szczegóły miejsca (nowe), Wyszukiwanie w pobliżu (nowe), lub Wyszukiwanie tekstowe (Nowe) w celu uzyskania nowyname
.
Wypróbuj
API Explorer umożliwia wysyłanie przykładowych żądań, aby zapoznać się z interfejsem API i jego opcjami.
Aby wysłać prośbę:
- Kliknij ikonę interfejsu API
. w prawej części strony.
- Ustaw parametr
name
na:places/PLACE_ID/photos/PHOTO_RESOURCE/media
- Ustaw
skipHttpRedirect
natrue
, aby żądanie zwracało kod JSON . Domyślnie żądanie zwraca obraz, którego nie może wyświetlić API Explorer. - Kliknij przycisk Wykonaj. W wyskakującym okienku wybierz konto, którego chcesz użyć. których użyć do przesłania żądania.
W panelu Eksplorator API kliknij ikonę rozwijania.
, aby rozwinąć okno Eksploratora interfejsów API.