Zdjęcie miejsca (nowe)

Wybierz platformę: Android iOS Usługa internetowa

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óbuj

Wysył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, parametr maxWidthPx 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.

Uwaga: aby uwzględnić tablicę photos[] w parametrze , pamiętaj o dołączeniu photos (Szczegóły miejsca) lub places.photos (wyszukiwanie w pobliżu i wyszukiwanie tekstowe) w masce pola żądania. Każdy Interfejs API może zwrócić maksymalnie 10 zdjęć dla lokalizacji miejsca.

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.

Uwaga: nazwy zdjęcia nie można zapisać w pamięci podręcznej. Nazwa pozwala też tracą ważność. Zadbaj o to, aby nazwa z odpowiedzi na żądanie pochodziła zawsze z Szczegóły miejsca (nowość), Wyszukiwanie w pobliżu (nowość), lub Wyszukiwanie tekstowe (nowość). Więcej informacji znajdziesz w ograniczeniach dotyczących buforowania opisanych w artykule 3.2.3(b)(Zakaz buforowania) do Warunki korzystania z usługi Google Maps Platform

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

Poniżej znajduje się 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 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:

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 ani maxWidthPx .
• Ustawiono wartość parametru maxHeightPx lub maxWidthtPx. do: null.
• Nagroda name wygasła. Jeśli name wygaśnie, utwórz prośba o Szczegóły miejsca (nowe), Wyszukiwanie w pobliżu (nowe), lub Wyszukiwanie tekstowe (Nowe) w celu uzyskania nowy name.

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ę:

1. Kliknij ikonę interfejsu API . w prawej części strony.
2. Ustaw parametr name na:

   places/PLACE_ID/photos/PHOTO_RESOURCE/media

   Uwaga: upewnij się, że używasz usługi name z niedawno wysłano prośbę o informacje o miejscu, ponieważ name może wygasnąć.
3. Ustaw skipHttpRedirect na true, aby żądanie zwracało kod 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ć. których użyć do przesłania żądania.

5. W panelu Eksplorator API kliknij ikonę rozwijania. , aby rozwinąć okno Eksploratora interfejsów API.