Podsumowania miejsc oparte na AI

Podsumowania miejsc oparte na AI to krótkie, 100-znakowe opisy konkretnych miejsc, które są powiązane z określonym identyfikatorem miejsca. Podsumowania miejsc zawierają wiele różnych typów danych w postaci ogólnego przeglądu, który pomaga użytkownikom uzyskać szybki wgląd w dane miejsce.

Na przykład w podsumowaniach miejsc mogą być wyróżnione popularne produkty, usługi lub towary dostępne w danym miejscu:

  • „Restauracja w Forum Shops serwująca duże porcje tradycyjnych dań kuchni włoskiej w nieformalnej atmosferze”.
  • „Stylowy salon oferujący strzyżenie i koloryzację włosów oraz modelowanie.”
  • „Duży sklep z wieloma sprzedawcami oferującymi różnorodne dekoracje w stylu vintage, meble i odzież”.

Podsumowania miejsc są obsługiwane przez usługi Place Details (New), Text Search (New) i Nearby Search (New). Podsumowania miejsc są dostępne w przypadku typów miejsc wymienionych w sekcji Obsługiwane typy w kategoriach Kultura, Rozrywka i rekreacja, Jedzenie i napoje, Zakupy, Usługi i Sport.

Podsumowania miejsc są obsługiwane w przypadku punktów orientacyjnych w tych językach i regionach:

Język Region
angielski

Indie

Stany Zjednoczone

Prośba o wygenerowanie podsumowania miejsca

Aby w odpowiedzi zwrócić podsumowanie miejsca, w masce pola żądania uwzględnij to pole:

  • Szczegóły miejsca (nowość): generativeSummary
  • Wyszukiwanie tekstowe (nowość) i wyszukiwanie w pobliżu (nowość): places.generativeSummary

Pole generativeSummary zawiera te pola:

  • generativeSummary: podsumowanie miejsca.
  • overviewFlagContentUri: link, w którym użytkownicy mogą zgłosić problem z podsumowaniem miejsca.
  • disclosureText: zlokalizowany ciąg tekstowy z tekstem informacji „Podsumowano za pomocą Gemini”, który musi być uwzględniony w atrybucjach.

Żądanie Informacje o miejscu (nowe)

Poniższa prośba o szczegóły miejsca (nowe) zwraca overview podsumowanie restauracji sushi w Chicago w stanie Illinois:

curl -X GET https://places.googleapis.com/v1/places/ChIJ1eOF7HLTD4gRry3xPjk8DkU \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,generativeSummary"

Odpowiedź ma postać:

{
  "displayName": {
    "text": "Sushi Nova - Lincoln Park",
    "languageCode": "en"
  },
  "generativeSummary": {
    "overview": {
      "text": "Casual eatery with all-you-can-eat sushi and other Japanese fare, plus beer and sake.",
      "languageCode": "en-US"
    },
    "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDg4MGZkMzcyZWM4NWUzZDU6MHg0NTBlM2MzOTNlZjEyZGFmMAI&d=17924085&t=12",
    "disclaimerText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Żądanie wyszukiwania tekstowego (nowe)

Poniższe żądanie wyszukiwania tekstowego (nowego) zwraca overview podsumowanie dotyczące pikantnych restauracji wegetariańskich w Mountain View w Kalifornii:

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias": {
    "rectangle": {
      "low": {
        "latitude": 37.415,
        "longitude": -122.091
      },
      "high": {
        "latitude": 37.429,
        "longitude": -122.065
      }
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchText'

Odpowiedź ma postać:

{
  "places": [
    {
      "id": "ChIJ8wN5kzm3j4AR_dRdUHoqrPI",
      "displayName": {
        "text": "Plant-Based Vegan Vietnamese",
        "languageCode": "en"
      }
    },
    {
      "id": "ChIJw4RuczO3j4ARC7RByZ5K9nI",
      "displayName": {
        "text": "sweetgreen",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering healthy, made-to-order salads, plates, and grain bowls with vegan options.",
          "languageCode": "en-US"
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzMzNzM2ZTg0YzM6MHg3MmY2NGE5ZWM5NDFiNDBiMAI&d=17924085&t=12",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

Prośba o wyszukiwanie w pobliżu (nowa)

Poniższe żądanie wyszukiwania w pobliżu (nowe) zwraca overviewpodsumowanie restauracji i kawiarni w Portland w stanie Oregon:

curl -X POST -d '{
  "maxResultCount": 5,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 45.553360,
        "longitude": -122.674934
        },
      "radius": 1000
    }
  },
  "includedTypes": ["restaurant", "cafe"],
  "excludedTypes": [],
  "rankPreference":"POPULARITY"
  }' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchNearby'

Odpowiedź ma postać:

{
  "places": [
    {
      "id": "ChIJOa08KlqnlVQR_ZZx1jEcTYY",
      "generativeSummary": {
        "overview": {
          "text": "BBQ and Thai street fare, plus imaginative tropical cocktails, served in a vibrant space.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJU4OzoWynlVQRxlQMpGenSvA",
      "generativeSummary": {
        "overview": {
          "text": "Beer hall with a big selection of German brews, plus a central courtyard with food trucks.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

Atrybucje

Wszystkie podsumowania oparte na AI wyświetlane w aplikacji muszą zawierać odpowiednie atrybucje zgodnie z zasadami i standardami Google. Więcej informacji znajdziesz w zasadach dotyczących interfejsu Places API.