Podsumowania obszarów oparte na AI

Podsumowania obszaru oparte na AI są generowane dla obszaru otaczającego dane miejsce. Podsumowania obszarów zawierają dodatkowe informacje o lokalizacji, w tym pobliskie atrakcje, 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 okolicy hotelu, aby dowiedzieć się więcej o otoczeniu:

  • „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óżnorodne restauracje. Wśród godnych uwagi miejsc warto wymienić kultową księgarnię City Lights Bookstore, fascynujące Muzeum Tramwaju Linowego i tętniące życiem ulice Chinatown.

    Obszar ten oferuje wyjątkowe połączenie historii i kultury. Jest przyjazny dla pieszych, co zachęca do zwiedzania, mimo że jest tu kilka wzgórz i tłumów. Zanurz się w historii literatury 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 Tramwajów Linowych. Czekają na Ciebie różnorodne opcje gastronomiczne, od autentycznej kuchni chińskiej po pyszną pizzę”.

Jeśli chcesz naładować pojazd elektryczny, możesz wyświetlić wygenerowane podsumowanie dotyczące stacji ładowania pojazdów elektrycznych, aby znaleźć kawiarnie lub restauracje w pobliżu, które możesz odwiedzić, czekając na naładowanie pojazdu:

  • „W tej okolicy, w odległości 9 minut spacerem, znajduje się wiele lokali gastronomicznych, w tym Starbucks, Sushi Jin i Safeway”.

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

Interfejs Places API (nowy) udostępnia 2 rodzaje podsumowań obszarów opartych na AI:

  • Podsumowania dzielnic, 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ń na stacjach ładowania pojazdów elektrycznych (EVCS), które zawierają ogólne informacje o pobliskich atrakcjach w miejscach typu electric_vehicle_charging_station.

Podsumowania obszarów oparte na AI są obsługiwane w przypadku tych usług:informacje o miejscu (nowość),Wyszukaj tekst (nowość) i Wyszukiwanie w pobliżu (nowość).

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

Język Region
angielski Stany Zjednoczone

Poproś o podsumowanie informacji o okolicy

Podsumowania dzielnic można generować w przypadku miejsc o typach premise, street_address i wszystkich typach w kategoriach Mieszkania i Obiekty noclegowe. Aby w odpowiedzi otrzymać podsumowanie okolicy, w masce pola żądania uwzględnij te informacje:

  • Informacje o miejscu (nowe): neighborhoodSummary
  • Wyszukiwanie tekstowe (nowość) i wyszukiwanie w pobliżu (nowość): places.neighborhoodSummary

Pole neighborhoodSummary miejsca w odpowiedzi zawiera te informacje:

  • Dwa pola podrzędne: overview i description. Podpole overview zawiera informacje o pobliskich ciekawych miejscach, a podpole description – 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.
  • flagContentUri Link, za pomocą którego użytkownicy mogą zgłosić problem z wygenerowanym podsumowaniem.
  • zlokalizowany ciąg tekstowy z tekstem informacji „Streszczono za pomocą Gemini”, który musi być uwzględniony w atrybucjach.

Ten przykład wysyła prośbę o podsumowanie 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 w przypadku miejsc typu electric_vehicle_charging_station. Aby uwzględnić w odpowiedzi podsumowanie udogodnień EVCS, w masce pola żądania umieść ten kod:

  • Informacje o miejscu (nowe): evChargeAmenitySummary
  • Wyszukiwanie tekstowe (nowość) i wyszukiwanie w pobliżu (nowość): places.evChargeAmenitySummary

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

  • 4 podpola: 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 „Streszczono za pomocą Gemini”, który musi być uwzględniony w atrybucjach;

W tym przykładzie wysyłamy prośbę o podsumowanie 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 taką 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 Twojej aplikacji muszą zawierać odpowiednie informacje o autorstwie zgodnie z zasadami i standardami Google. Więcej informacji znajdziesz w zasadach dotyczących interfejsu Places API.