podsumowania opinii generowane przez AI,

Podsumowania opinii generowane przez AI to podsumowania miejsc wygenerowane przez AI na podstawie opinii użytkowników. Dzięki syntezie kluczowych elementów opinii użytkowników, takich jak atrybuty miejsca i opinie recenzentów, podsumowania opinii zawierają ogólne informacje i pomagają użytkownikom podejmować świadome decyzje.

Na przykład podsumowanie opinii o budynku Ferry Building w San Francisco zawiera informacje o jedzeniu i zakupach, a także o widokach i atmosferze:

„Odwiedzający twierdzą, że ten zabytkowy budynek oferuje różnorodny wybór sklepów, restauracji i targów rolnych, a wielu z nich chwali widoki na zatokę i miasto. Podkreślają też żywą atmosferę, wygodny dostęp do promu do innych miejsc oraz możliwość korzystania z usług lokalnych firm”.

Podsumowania opinii są obsługiwane w nowych wersjach Szczegółów miejsca, Wyszukiwania tekstu, i Wyszukiwania w pobliżu.

Podsumowania opinii są obsługiwane w przypadku interesujących miejsc w tych językach i regionach:

Język Region
angielski Argentyna, Boliwia, Brazylia, Chile, Dominikana Republika, Ekwador, Gwatemala, Indie, Japonia, Kolumbia, Kostaryka, Meksyk, Paragwaj, Peru, Stany Zjednoczone, Urugwaj, Wenezuela, Wielka Brytania
japoński Japonia
portugalski Brazylia
hiszpański Argentyna, Boliwia, Chile, Dominikana, Ekwador, Gwatemala, Kolumbia, Kostaryka, Meksyk, Paragwaj, Peru, Stany Zjednoczone, Urugwaj, Wenezuela

Prośba o podsumowanie opinii

Aby poprosić o podsumowanie opinii, dodaj reviewSummary do maski pola w żądaniu:

  • Szczegóły miejsca (nowe): reviewSummary
  • Wyszukiwanie tekstu (nowe) i Wyszukiwanie w pobliżu (nowe): places.reviewSummary

Atrybucje podsumowania opinii muszą zawierać link do opinii o miejscu w Mapach Google. Aby pobrać ten link, dodaj reviewSummary.reviewsUri do maski pola w żądaniu.

Treść odpowiedzi zawiera 3 pola:

  • text: podsumowanie opinii wygenerowane przez AI.
  • flagContentUri: służy do zgłaszania nieodpowiednich treści do usunięcia przez Google.
  • disclosureText: zlokalizowany ciąg tekstowy z tekstem ujawnienia „Podsumowano za pomocą Gemini”, który musi być uwzględniony w atrybucjach.

Żądanie informacji o miejscu (nowe)

Ten przykład żąda podsumowania opinii o restauracji z pierogami w Nowym Jorku:

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

Odpowiedź ma postać:

{
  "displayName": {
    "text": "Dumpling House",
    "languageCode": "en"
  },
  "reviewSummary": {
    "text": {
      "text": "People say this restaurant serves delicious dumplings, noodles, and pork belly buns. They highlight the generous portions, reasonable prices, and quick service. They also like the friendly and accommodating staff.",
      "languageCode": "en-US"
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEE%7CCAIQACorChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEESDAikt7HDBhDopLLxAg&d=17924085&t=8",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    },
    "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89d14bb69376690f:0x53d61573fb1dcd0b!9m1!1b1"
  }
}

Żądanie Wyszukiwania tekstu (nowe)

Ten przykład żąda podsumowania opinii o kawiarni w Nowym Jorku:

curl -X POST -d '{
  "textQuery": "coffee shop",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 40.722630,
        "longitude": -74.001397
      }
    }
  },
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary" \
'https://places.googleapis.com/v1/places:searchText'

Treść odpowiedzi ma postać:

{
  "places": [
    {
      "id": "ChIJyfJXNphZwokRbo-oe0DjVT4",
      "reviewSummary": {
        "text": {
          "text": "People say this coffee shop serves up delicious oat milk lattes, cold brew, and pastries, such as almond croissants and cheese danish. They also highlight the friendly staff, cozy atmosphere, and outdoor seating.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFE%7CCAIQACorChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFESDAj7p9_BBhCYsoeAAw&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259983657f2c9:0x3e55e3407ba88f6e!9m1!1b1"
      }
    },
    {
      "id": "ChIJHcFFXH9ZwokR_QKedPacLiQ",
      "reviewSummary": {
        "text": {
          "text": "People say this cafe offers delicious matcha, lattes, and freshly baked pastries, including the popular rose honey latte and blueberry lemon muffin. They highlight the spacious, chill, and cinema-inspired vibe, perfect for working or socializing, and the fast, friendly service. They also like the free WiFi, outlets, and clean restrooms.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelE%7CCAIQACorChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelESDAikt7HDBhDopLLxAg&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c2597f5c45c11d:0x242e9cf6749e02fd!9m1!1b1"
      }
    },
    ...
  ]
}

Żądanie Wyszukiwania w pobliżu (nowe)

Ten przykład żąda hoteli w pobliżu centrum Seattle:

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

Odpowiedź ma postać:

{
  "places": [
    {
      "id": "ChIJRwVmS-BrkFQRpAB3pO5JOuQ",
      "reviewSummary": {
        "text": {
          "text": "People say this hotel offers clean, modern, and spacious rooms with comfortable beds and phenomenal city views. They highlight the convenient downtown location, with easy walking access to popular attractions, and the efficient self-parking option. They also like the friendly and helpful staff, and the smooth check-in and check-out process.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOlJWVG5YOXZrSnZhTXBqUy1rc1JZc3c%7CCAIQACorChtyc19oOlJWVG5YOXZrSnZhTXBqUy1rc1JZc3cSDAikt7HDBhDopLLxAg&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906be04b660547:0xe43a49eea47700a4!9m1!1b1"
      }
    },
    {
      "id": "ChIJQVJVX7RqkFQRcpsm3VVub9U",
      "reviewSummary": {
        "text": {
          "text": "People say this hotel offers spacious rooms, a convenient location near the convention center and Pike Place Market, and a tasty restaurant. They also highlight the friendly and attentive staff, the comfortable beds and pillows, and the convenient amenities such as a Starbucks in the lobby and a club lounge.\n\nSome reviews mention the rooms can be noisy.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOldJVUlodGhTUTJOdUdTSmFxQWw2Nnc%7CCAIQACorChtyc19oOldJVUlodGhTUTJOdUdTSmFxQWw2NncSDAikt7HDBhDopLLxAg&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906ab45f555241:0xd56f6e55dd269b72!9m1!1b1"
      }
    },
    ...
  ]
}

Atrybucje

Wszystkie podsumowania generowane przez AI wyświetlane w Twojej aplikacji muszą być opatrzone odpowiednią atrybucją zgodnie z zasadami i standardami Google. Więcej informacji znajdziesz w artykule Zasady dotyczące interfejsu Places API.