Podsumowania obszarów oparte na AI

Podsumowania obszarów oparte na AI są generowane dla obszaru otaczającego miejsce. Podsumowania obszarów zawierają dodatkowe informacje o lokalizacji, w tym pobliskie ciekawe miejsca, dzięki czemu użytkownicy mogą podejmować bardziej świadome decyzje o tym, gdzie się udać i co robić po przybyciu na miejsce.

Gdy odwiedzasz nowe miasto, możesz wyświetlić wygenerowane podsumowanie dzielnicy, w której znajduje się hotel, aby dowiedzieć się więcej o okolicy:

  • „Ta tętniąca życiem dzielnica San Francisco, łącząca North Beach i Chinatown, znajduje się na północny zachód od dzielnicy finansowej i oferuje zabytki literackie, wyjątkowe atrakcje kulturalne i różnorodną kuchnię. Warto odwiedzić m.in. kultową księgarnię City Lights Bookstore, fascynujące Muzeum Kolejki Linowej i tętniące życiem ulice Chinatown.

    Obszar ten oferuje wyjątkowe połączenie historii i kultury. Przyjazne pieszym otoczenie zachęca do zwiedzania, mimo że jest tu kilka wzgórz i tłumów. Zanurz się w literackiej historii w księgarni City Lights, poznaj tętniącą życiem kulturę Chinatown z jej świątyniami i fabrykami ciasteczek z wróżbą lub cofnij się w czasie w Muzeum Kolejki Linowej. Czeka na Ciebie wiele lokali gastronomicznych, od autentycznej kuchni chińskiej po pyszną pizzę”.

Jeśli planujesz naładować pojazd elektryczny, możesz wyświetlić wygenerowane podsumowanie stacji ładowania, aby znaleźć w pobliżu kawiarnie lub restauracje, które możesz odwiedzić w czasie oczekiwania:

  • „W okolicy znajduje się wiele lokali gastronomicznych, do których można dojść w 9 minut. Są to m.in. Starbucks, Sushi Jin i Safeway”.

Odpowiedź zawiera opis obszaru oraz listę identyfikatorów miejsc, o których mowa w opisie.

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

  • Podsumowania okolicy, które zawierają ogólne informacje o atrakcjach w pobliżu miejsc o typach premise, street_address i wszystkich typach w kategoriach Mieszkania i Obiekty noclegowe.
  • Podsumowania udogodnień stacji ładowania pojazdów elektrycznych, które zawierają ogólne informacje o atrakcjach w pobliżu miejsc o typie electric_vehicle_charging_station.

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

Prośba o podsumowanie okolicy

Podsumowania dzielnic można generować w przypadku miejsc należących do kategorii Mieszkania i Obiekty noclegowe. Aby w odpowiedzi otrzymać podsumowanie okolicy, w masce pola żądania uwzględnij te informacje:

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

Pole neighborhoodSummary w odpowiedzi dotyczącej miejsca zawiera te informacje:

  • Dwa pola podrzędne: overview i description. Pole podrzędne overview zawiera pobliskie ciekawe miejsca związane z danym miejscem, a pole podrzędne description zawiera bardziej ogólne informacje o okolicy. Każde pole podrzędne zawiera listę nazw zasobów miejsc, do których się odwołuje, w formacie place/PLACE_ID.
  • Link flagContentUri, za pomocą którego użytkownicy mogą zgłosić problem z wygenerowanym podsumowaniem.
  • Lokalizowany ciąg tekstowy z tekstem „Podsumowano za pomocą Gemini”, który musi być uwzględniony w atrybucjach.

Poniższy przykład ilustruje, jak wysyłać żądanie podsumowania okolicy 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 udogodnień związanych ze stacjami ładowania pojazdów elektrycznych

Podsumowania udogodnień stacji ładowania pojazdów elektrycznych (EVCS) mogą być generowane dla miejsc typu electric_vehicle_charging_station. Aby uwzględnić w odpowiedzi podsumowanie udogodnień EVCS, w masce pola żądania umieść ten kod:

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

Pole evChargeAmenitySummary w odpowiedzi dotyczącej miejsca zawiera te informacje:

  • 4 pola podrzędne: overview, coffee, restaurant i store. Każde pole podrzędne zawiera krótki opis pobliskich ciekawych miejsc i listę nazw zasobów miejsc, do których się odwołuje, w formacie place/PLACE_ID.
  • flagContentUri Link, za pomocą którego użytkownicy mogą zgłosić problem z wygenerowanym podsumowaniem.
  • Zlokalizowany ciąg tekstowy z tekstem „Podsumowano za pomocą Gemini”, który musi być uwzględniony w atrybucjach.

W tym przykładzie wysyłamy żądanie podsumowania udogodnień 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 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.