Zdjęcie miejsca (nowe)

Wybierz platformę: Android iOS Usługa internetowa

Usługa Zdjęcie miejsca (nowa) to interfejs API tylko do odczytu, który umożliwia dodawanie do aplikacji wysokiej jakości treści fotograficznych. Usługa Zdjęcia miejsca zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsca.

Gdy uzyskujesz informacje o miejscu za pomocą żądania dotyczącego szczegółów miejsca, wyszukiwania w pobliżu lub wyszukiwania tekstowego, 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 zdjęć, do których odwołuje się aplikacja, oraz zmienić rozmiar obrazu do optymalnego rozmiaru dla aplikacji.

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

Wypróbuj

Zdjęcia miejsca

Żądanie Zdjęcie miejsca to żądanie HTTP GET do adresu URL w formie:
https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS

Wymagane są te parametry:

  • NAME zawiera nazwę zasobu zdjęcia.
  • API_KEY zawiera klucz interfejsu API.
  • PARAMETERS zawiera albo parametr maxHeightPx, albo parametr maxWidthPx, albo oba te parametry.

Pełna lista wymaganych i opcjonalnych parametrów została podana poniżej.

Wymagane parametry

Nazwa zdjęcia

Identyfikator ciągu znaków, który jednoznacznie identyfikuje zdjęcie. Nazwy zdjęć są zwracane z żądania Szczegóły miejsca (nowa), Wyszukiwanie w pobliżu (nowa) lub Wyszukiwanie tekstu (nowa) w właściwości name każdego elementu tablicy photos[].

Przykład znajdziesz w sekcji Pobieranie nazwy zdjęcia.

maxHeightPx i maxWidthPx

Określa maksymalną wysokość i szerokość obrazu (w pikselach). Jeśli obraz jest mniejszy niż określone wartości, zwrócony zostanie oryginalny obraz. Jeśli obraz jest większy w jednym z wymiarów, zostanie przeskalowany, aby pasował do mniejszego z tych wymiarów, zachowując oryginalny format. Właściwości maxheight i maxwidth akceptują liczby całkowite z zakresu od 1 do 4800.

Musisz podać wartość maxHeightPx, maxWidthPx lub obie te wartości.

Parametry opcjonalne

skipHttpRedirect

Jeśli false (domyślnie), przekieruj HTTP do obrazu, aby zwrócić obraz. Jeśli true, pomiń przekierowanie i zwróć odpowiedź JSON zawierającą szczegóły 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.

Pobieranie nazwy zdjęcia

Wszystkie żądania wysyłane do usługi Zdjęcia miejsca muszą zawierać nazwę zasobu zdjęcia zwróconą w odpowiedzi na żądanie wyszukiwania w pobliżu, wyszukiwania tekstowego lub żądanie Szczegóły miejsca. Odpowiedź na te żądania zawiera tablicę photos[], jeśli miejsce ma powiązane treści fotograficzne.

Każdy element photo[] zawiera te pola:

  • name – ciąg tekstowy zawierający nazwę zasobu zdjęcia, gdy wykonujesz żądanie dotyczące zdjęcia. Ten ciąg ma postać:

    places/PLACE_ID/photos/PHOTO_RESOURCE
  • heightPx – maksymalna wysokość obrazu w pikselach.
  • widthPx – maksymalna szerokość obrazu w pikselach.
  • authorAttributions[] – wszelkie wymagane informacje o autorze. To pole jest zawsze obecne, ale może być puste.

Zdjęcia zwracane przez usługę Zdjęcia pochodzą z różnych źródeł, w tym od właścicieli firm i użytkowników. W większości przypadków można ich używać bez przypisów, ale mogą one zawierać wymagane informacje. Jeśli jednak zwrócony element photo zawiera wartość w polu authorAttributions, musisz dodać dodatkowe informacje o źródle w aplikacji w miejscach, w których wyświetlasz obraz.

Poniższy przykład pokazuje żądanie szczegółów miejsca, które zawiera pole photos w masce pola, dzięki czemu odpowiedź zawiera 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 jego rozmiar tak, aby miał co najwyżej 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 umieszczenia zdjęcia zawiera obraz. Typ obrazu zależy od typu pierwotnie przesłanego zdjęcia.

Jeśli żądanie przekracza dostępny limit, serwer zwraca stan HTTP 403 i wyświetla obrazek poniżej, aby wskazać, że limit został przekroczony:

Obraz dotyczący przekroczenia limitu

Jeśli serwer nie może zrozumieć żądania, zwraca kod stanu HTTP 400, który wskazuje na nieprawidłowe żądanie. Najczęstsze przyczyny nieprawidłowego żądania to:

  • Podane imię i nazwisko są niezgodne z imieniem i nazwiskiem w przesłanym dokumencie tożsamości ze zdjęciem wydanym przez organ państwowy.
  • Żądanie nie zawierało parametru maxHeightPx ani maxWidthPx.
  • Wartość parametru maxHeightPx lub maxWidthtPx została ustawiona na null.
  • name wygasło. Jeśli name wygaśnie, wyślij prośbę o utworzenie nowego name za pomocą funkcji Szczegóły miejsca (Nowa), Wyszukiwanie w pobliżu (Nowa) lub Wyszukiwanie tekstowe (Nowa).

Wypróbuj

Narzędzie API Explorer umożliwia wysyłanie przykładowych żądań, dzięki czemu możesz zapoznać się z interfejsem API i jego opcjami.

Aby poprosić o pomoc:

  1. Po prawej stronie strony kliknij ikonę interfejsu API Rozwiń narzędzie API Explorer..
  2. Ustaw parametr name: 
    places/PLACE_ID/photos/PHOTO_RESOURCE/media
    name
  3. Ustaw wartość parametru skipHttpRedirect na true, aby żądanie zwracało odpowiedź w formacie JSON. Domyślnie żądanie zwraca obraz, którego Eksplorator interfejsu API nie może wyświetlić.
  4. Kliknij przycisk Wykonaj. W wyskakującym okienku wybierz konto, którego chcesz użyć do wysłania żądania.

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