Podsumowania obszarów oparte na AI

Dla obszaru wokół danego miejsca generowane są podsumowania oparte na AI. Podsumowania obszarów zapewniają dodatkowy kontekst dotyczący lokalizacji, w tym pobliskich punktów zainteresowania, dzięki czemu użytkownicy mogą podejmować bardziej świadome decyzje dotyczące tego, dokąd się udać i co tam robić.

Na przykład podczas wizyty w nowym mieście możesz wyświetlić wygenerowany opis dzielnicy, w której znajduje się hotel, aby dowiedzieć się więcej o okolicy:

  • „Ta tętniąca życiem dzielnica w San Francisco, łącząca North Beach i Chinatown, znajduje się na północny zachód od Financial District. Znajdują się w niej miejsca związane z literaturą, wyjątkowe atrakcje kulturalne i różnorodne restauracje. Warto odwiedzić kultarną księgarnię City Lights, fascynujące Muzeum Tramwajów oraz tętniące życiem ulice dzielnicy Chinatown.

    Ten region oferuje wyjątkowe połączenie historii i kultury, a przyjazne dla pieszych otoczenie zachęca do odkrywania okolicy, mimo pagórków i tłoku. Zagłęb się w historii literatury w księgarni City Lights, poznaj barwną kulturę Chinatown z jej świątyniami i fabrykami ciasteczek z wróżbą lub cofnij się w czasie w Muzeum Kolejki Linowej. Na gości czekają różne opcje gastronomiczne, od autentycznych dań kuchni chińskiej po pyszną pizzę”.

Jeśli rozważasz ładowanie pojazdu elektrycznego, możesz wyświetlić wygenerowane podsumowanie dotyczące stacji ładowania pojazdów elektrycznych, aby znaleźć pobliskie kawiarnie lub restauracje, które możesz odwiedzić podczas oczekiwania:

  • „W tym rejonie w odległości 9-minutowego spaceru znajduje się wiele restauracji, w tym Starbucks, Sushi Jin i Safeway”.

Oprócz opisu obszaru odpowiedź zawiera też listę identyfikatorów miejsc, do których odwołuje się opis.

Places API (nowość) udostępnia 2 rodzaje podsumowań obszarów opartych na AI:

  • Podsumowania dotyczące okolic, które zawierają ogólny opis pobliskich atrakcji dla miejsc o typach premise, street_address i wszystkich typów w kategoriach ZakwaterzeNoclegi.
  • Podsumowania udogodnień na stacjach ładowania pojazdów elektrycznych, które zawierają ogólny opis pobliskich atrakcji w przypadku miejsc typu electric_vehicle_charging_station.

Podsumowania obszarów oparte na AI są obsługiwane w szczegółach miejsc (nowość), wyszukiwaniu tekstowym (nowość)wyszukiwaniu w pobliżu (nowość).

Wysyłanie prośby o podsumowanie dotyczącego sąsiedztwa

Podsumowania dotyczące okolic można generować w przypadku miejsc należących do kategorii MieszkanieNoclegi. Aby w odpowiedzi zwrócić podsumowanie sąsiedztwa, w polu maski żądania podaj:

  • Szczegóły miejsca (nowa wersja): neighborhoodSummary
  • Wyszukiwanie tekstowe (nowa funkcja)Wyszukiwanie w pobliżu (nowa funkcja): places.neighborhoodSummary

Pole neighborhoodSummary w odpowiedzi zawiera:

  • 2 pola podrzędne: overviewdescription. Podpole overview zawiera informacje o punktach zainteresowania w pobliżu danego miejsca, a podpole description zawiera informacje ogólne o otaczającej okolicy. Każde podpole zawiera listę nazw zasobów miejsca w formacie place/PLACE_ID.
  • flagContentUriLink, w którym użytkownicy mogą zgłosić problem z wygenerowanym podsumowaniem.
  • zlokalizowany ciąg tekstowy z tekstem informującym o tym, że tekst został streszczony za pomocą Gemini, który musi zostać uwzględniony w przypisach;

W tym przykładzie żądamy podsumowania informacji o okolicach hotelu w Nowym Jorku:

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

Odpowiedź ma postać:

{
  "id": "ChIJT0DdRo1ZwokRkufwSD-TdGM",
  "displayName": {
    "text": "Courtyard New York Manhattan/SoHo",
    "languageCode": "en"
  }
  "neighborhoodSummary": {
    "overview": {
      "content": {
        "text": "This area resides within SoHo, a trendy Lower Manhattan neighborhood celebrated for its upscale boutiques, designer shops, and thriving art scene. The area is home to the Color Factory and Dominique Ansel Bakery, known for its popular Cronuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "description": {
      "content": {
        "text": "SoHo's walkability and convenient public transportation options make exploration easy. A diverse array of restaurants and cafes cater to varied tastes. SoHo's central location, surrounded by vibrant neighborhoods, contributes to its fast-paced and energetic atmosphere, with a focus on fashion and design.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=&d=17924085&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Prośba o podsumowanie informacji o udogodnieniach w EVCS

Podsumowania udogodnień stacji ładowania pojazdów elektrycznych (EVCS) mogą być generowane w przypadku miejsc o typie electric_vehicle_charging_station. Aby podsumowanie udogodnień EVCS znalazło się w odpowiedzi, w polu maski prośby podaj:

  • Szczegóły miejsca (nowa wersja): evChargeAmenitySummary
  • Wyszukiwanie tekstowe (nowa funkcja)Wyszukiwanie w pobliżu (nowa funkcja): places.evChargeAmenitySummary

Pole evChargeAmenitySummary w odpowiedzi zawiera:

  • 4 podpola: overview, coffee, restaurantstore. Każde podpole zawiera krótki opis pobliskich punktów zainteresowania oraz listę nazw zasobów miejsc w formacie place/PLACE_ID.
  • Link flagContentUri, za pomocą którego użytkownicy mogą zgłosić problem z wygenerowanym podsumowaniem.
  • Zlokalizowany ciąg tekstowy z tekstem informującym o tym, że tekst został streszczony za pomocą Gemini, który musi zostać uwzględniony w przypisach.

W tym przykładzie żądamy podsumowania udogodnień na stacji ładowania EV w Mountain View:

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

Odpowiedź ma postać:

{
  "id": "ChIJf8j-4z23j4AR_MQ2-bgMmrY",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "evChargeAmenitySummary": {
    "overview": {
      "content": {
        "text": "Within a short walk, there are several coffee and restaurant options, including Clocktower Coffee Roasting Company, Khao Kang Thai Kitchen, and Roger's Deli & Donuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q",
        /.../
      ]
    },
    "coffee": {
      "content": {
        "text": "Clocktower Coffee Roasting Company has Wi-Fi and a variety of coffee and pastries in a laid-back atmosphere.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q"
      ]
    },
    "restaurant": {
      "content": {
        "text": "Roger's Deli & Donuts is a bustling deli with sandwiches and breakfast items.\nJoy Sushi serves classic Japanese dishes, including vegetarian and healthy options.\nSubway is a chain sandwich shop offering its usual subs, wraps, and salads.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJQ4F3PBa3j4ARf7_QjN1Cklo",
        /.../
      ]
    },
    "store": {
      "content": {
        "text": "Rotten Robbie is a chain gas station with a convenience store and a restroom.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJA6deFBa3j4AREY0EyTEGhN8",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ABCDEFG=1234567&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Atrybucje

Wszystkie podsumowania generowane przez AI wyświetlane w aplikacji muszą być opatrzone odpowiednim powiadomieniem zgodnie z zasadami i standardami Google. Więcej informacji znajdziesz w zasadach dotyczących interfejsu Places API.