Podsumowania obszarów oparte na AI

Podsumowania obszarów oparte na AI są generowane dla obszaru otaczającego dane miejsce. Podsumowania obszarów zawierają dodatkowe informacje o lokalizacji, w tym o pobliskich miejscach, które mogą zainteresować użytkowników. Dzięki temu mogą oni podejmować bardziej świadome decyzje dotyczące tego, gdzie się udać i co robić po przybyciu na miejsce.

Jeśli na przykład odwiedzasz nowe miasto, możesz wyświetlić wygenerowane podsumowanie okolicy hotelu, 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óżnorodne lokale gastronomiczne. Wśród godnych uwagi miejsc znajdują się kultowa księgarnia City Lights, fascynujące Muzeum Kolejki Linowej i tętniące życiem ulice Chinatown”.

    „Ta okolica to wyjątkowe połączenie historii i kultury. Przyjazne pieszym otoczenie zachęca do zwiedzania, mimo że jest tu trochę 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 Kolejki Linowej. Czeka na Ciebie wiele lokali gastronomicznych, od autentycznej kuchni chińskiej po pyszną pizzę."

Jeśli rozważasz naładowanie pojazdu elektrycznego, możesz wyświetlić wygenerowane podsumowanie stacji ładowania pojazdów elektrycznych, aby znaleźć pobliskie kawiarnie lub restauracje, które możesz odwiedzić podczas 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, o których mowa w opisie.

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

  • Podsumowania okolicy, które zawierają ogólne informacje o pobliskich atrakcjach w przypadku miejsc typu premise, street_address i wszystkich typów z Mieszkania i Obiekty noclegowe kategorii.
  • Podsumowania udogodnień stacji ładowania pojazdów elektrycznych (EVCS), które zawierają ogólne informacje o pobliskich atrakcjach w przypadku miejsc typu electric_vehicle_charging_station.

Podsumowania obszarów oparte na AI są obsługiwane w przypadku informacji o miejscu (nowość), wyszukiwania tekstowego (nowość), i wyszukiwania w pobliżu (nowość).

Podsumowania obszarów są obsługiwane w przypadku miejsc, które mogą zainteresować użytkowników, w tych językach i regionach:

Język Region
angielski Stany Zjednoczone

Wysyłanie prośby o podsumowanie okolicy

Podsumowania okolicy można generować w przypadku miejsc typu premise, street_address, i wszystkich typów z kategorii Mieszkania i Obiekty noclegowe. Aby w odpowiedzi uwzględnić podsumowanie okolicy, w masce pola żądania dodaj te informacje:

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

Pole neighborhoodSummary w odpowiedzi zawiera te informacje:

  • 2 pola podrzędne: overview i description. Pole podrzędne overview zawiera pobliskie miejsca, które mogą zainteresować użytkowników, a pole podrzędne description – ogólne informacje o okolicy. Każde pole podrzędne zawiera 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 „Podsumowano za pomocą Gemini”, który musi być uwzględniony w atrybucjach.

Ten przykład pokazuje, jak wysł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"
    }
  }
}

Wysyłanie prośby o podsumowanie udogodnień EVCS

Podsumowania udogodnień stacji ładowania pojazdów elektrycznych (EVCS) można generować w przypadku miejsc typu electric_vehicle_charging_station. Aby w odpowiedzi uwzględnić podsumowanie udogodnień EVCS, w masce pola żądania dodaj te informacje:

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

Pole evChargeAmenitySummary w odpowiedzi zawiera te informacje:

  • 4 pola podrzędne: overview, coffee, restaurant i store. Każde pole podrzędne zawiera krótki opis pobliskich miejsc, które mogą zainteresować użytkowników, 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 „Podsumowano za pomocą Gemini”, który musi być uwzględniony w atrybucjach.

Poniższy przykład pokazuje, jak wysłać 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ć odpowiednią atrybucję zgodnie z zasadami i standardami Google. Więcej informacji znajdziesz w artykule Zasady dotyczące interfejsu Places API.