podsumowania opinii generowane przez AI,

Podsumowania opinii oparte na AI to wygenerowane przez AI podsumowania miejsc na podstawie opinii użytkowników. Podsumowania opinii zawierają najważniejsze elementy opinii użytkowników, takie jak atrybuty miejsca i nastawienie recenzenta. Dostarczają one ogólnych informacji i pomagają użytkownikom podejmować świadome decyzje.

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

„Odwiedzający twierdzą, że ten historyczny punkt orientacyjny oferuje różnorodny wybór sklepów, restauracji i targów rolnych. Wielu chwali widoki na zatokę i miasto. Podkreślają też tętniącą życiem atmosferę, wygodny dostęp do innych miejsc promem i możliwość korzystania z usług lokalnych firm”.

Podsumowania opinii są obsługiwane w przypadku tych usług: Szczegóły miejsca (nowe), Wyszukiwanie tekstowe (nowe) i Wyszukiwanie w pobliżu (nowe).

Podsumowania opinii są dostępne w przypadku punktów orientacyjnych w tych językach i regionach:

Język Region
angielski

Indie

Japonia

Wielka Brytania

Stany Zjednoczone
japoński Japonia

Prośba o podsumowanie opinii

Aby poprosić o podsumowanie opinii, w masce pola żądania dodaj reviewSummary:

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

Atrybucje podsumowania opinii muszą zawierać link do opinii o miejscu w Mapach Google. Aby pobrać ten link, w masce pola żądania umieść reviewSummary.reviewsUri.

Treść odpowiedzi zawiera 3 pola:

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

Żądanie Informacje o miejscu (nowe)

W tym przykładzie wysyłamy prośbę o podsumowanie opinii o restauracji serwującej pierogi 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 tekstowego (nowe)

Poniższy przykład ilustruje, jak wysyłać żądanie podania 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"
      }
    },
    ...
  ]
}

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

Poniższy przykład ilustruje, jak wysyłać żądanie podania 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 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.