Zdjęcie miejsca (nowe)

Wybierz platformę: Android iOS Usługa internetowa

Usługa Place Photo (nowość) to interfejs API tylko do odczytu, który umożliwia dodawanie do aplikacji wysokiej jakości treści fotograficznych. Usługa Place Photo daje dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc.

Po otrzymaniu informacji o miejscu przy użyciu żądania „Szczegóły miejsca”, „Wyszukiwanie w pobliżu” lub „Wyszukiwanie tekstowe” możesz też poprosić o zasoby zdjęć dla odpowiednich treści fotograficznych. Korzystając z usługi Zdjęcia, możesz uzyskać dostęp do wybranych zdjęć i zmienić rozmiar obrazu do optymalnego rozmiaru dla swojej aplikacji.

API Explorer umożliwia wysyłanie żądań na żywo, dzięki czemu możesz zapoznać się z interfejsem API i jego opcjami:

Wypróbuj

Wysyłanie próśb o zdjęcia

Żądanie zdjęcia miejsca to żądanie HTTP GET wysyłane 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.
• PARAMETERS zawiera parametr maxHeightPx, maxWidthPx lub oba.

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 w odpowiedzi na żądanie Szczegóły miejsca (nowe), Wyszukiwanie w pobliżu (nowe) lub Wyszukiwanie 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 będzie mniejszy niż określone wartości, zwrócony zostanie obraz oryginalny. Jeśli obraz jest większy w dowolnym z tych wymiarów, zostanie przeskalowany tak, by dopasować go do mniejszego z tych 2 wymiarów w ograniczeniu do pierwotnego formatu 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 zawierającą błąd 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

Żądania wysyłane do usługi Zdjęcia miejsca muszą zawierać nazwę zasobu zdjęcia zwracaną w odpowiedzi na żądanie Wyszukiwanie w pobliżu, Wyszukiwanie tekstowe lub Informacje o miejscu. Odpowiedź na te żądania zawiera tablicę photos[], jeśli miejsce ma powiązane treści fotograficzne.

Uwaga: aby w odpowiedzi uwzględnić tablicę photos[], pamiętaj, by w masce pola żądania umieścić photos (Szczegóły miejsca) lub places.photos (Wyszukiwanie w pobliżu i Wyszukiwanie tekstowe). Każdy interfejs API może zwrócić maksymalnie 10 zdjęć dla danej lokalizacji miejsca.

Każdy element photo[] zawiera te pola:

• name – ciąg tekstowy zawierający nazwę zasobu zdjęcia wysyłanego podczas wykonywania żądania 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. To pole jest zawsze obecne, ale może być puste.

Zdjęcia zwracane przez usługę Zdjęcia pochodzą z różnych lokalizacji, między innymi od właścicieli firm i użytkowników. W większości przypadków zdjęcia te mogą zostać wykorzystane bez informacji o autorze lub zawierają wymagane informacje o autorze, które są częścią zdjęcia. Jeśli jednak zwrócony element photo zawiera wartość w polu authorAttributions, podczas wyświetlania obrazu musisz uwzględnić w aplikacji dodatkową atrybucję.

Uwaga: nazwy zdjęcia nie można zapisać w pamięci podręcznej. Poza tym ta nazwa może wygasnąć. Upewnij się, że zawsze podawana jest nazwa z odpowiedzi na zapytanie Szczegóły miejsca (nowe), Wyszukiwanie w pobliżu (nowe) lub Wyszukiwanie tekstowe (nowe). Więcej informacji znajdziesz w ograniczeniach dotyczących buforowania określonych w artykule 3.2.3(b)(Zakaz zapisywania w pamięci podręcznej) Warunków korzystania z Google Maps Platform.

Poniższy przykład pokazuje żądanie informacji o miejscu, w którym maska pola zawiera atrybut photos, tak 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

Poniżej znajdziesz przykład tablicy 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, zmieniając rozmiar na 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ź na żądanie dotyczące 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 zwraca stan HTTP 403 i wyświetla poniższy obraz, aby zasygnalizować przekroczenie limitu:

Jeśli serwer nie zrozumie Twojego żądania, zwraca stan HTTP 400, co oznacza nieprawidłowe żądanie. Oto najczęstsze przyczyny nieprawidłowego żądania:

• Podana nazwa zdjęcia jest nieprawidłowa.
• Żądanie nie zawierało parametru maxHeightPx ani maxWidthPx.
• Wartość parametru maxHeightPx lub maxWidthtPx została ustawiona na null.
• Nagroda name wygasła. Jeśli parametr name wygaśnie, poproś o szczegóły miejsca (nowe), wyszukiwanie w pobliżu (nowe) lub wyszukiwanie tekstowe (nowe), aby uzyskać nowy name.

Wypróbuj

API Explorer umożliwia wykonywanie przykładowych żądań, aby zapoznać się z interfejsem API i jego opcjami.

Aby wysłać prośbę:

1. Wybierz ikonę interfejsu API () po prawej stronie.
2. Ustaw parametr name na:

   places/PLACE_ID/photos/PHOTO_RESOURCE/media

   Uwaga: upewnij się, że używasz pola name z ostatniej prośby o informacje o miejscu, ponieważ name może wygasnąć.
3. Ustaw skipHttpRedirect na true, aby żądanie zwracało odpowiedź JSON. Domyślnie żądanie zwraca obraz, którego nie może wyświetlić API Explorer.
4. Kliknij przycisk Wykonaj. W wyskakującym okienku wybierz konto, którego chcesz użyć do przesłania prośby.

5. W panelu API Explorer kliknij ikonę rozwijania , aby rozwinąć okno API Explorer.