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 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 słynie z ważnych miejsc związanych z literaturą, wyjątkowych atrakcji kulturalnych i różnorodnej oferty gastronomicznej. Warto odwiedzić m.in. kultową księgarnię City Lights, 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 Bookstore, 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. Czekają na Ciebie różnorodne opcje gastronomiczne, od autentycznej kuchni chińskiej po pyszną pizzę”.

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

  • „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 (nowość) 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ń 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: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

Prośba o podsumowanie 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 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.
  • 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 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 „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 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.