możliwości modelu Gemini dla interfejsu Places API.

Możliwości modelu Gemini w interfejsie Places API (nowy) zapewniają obsługę LLM w interfejsie Places API, dzięki czemu możesz zwracać dane powiązane z miejscem (godziny otwarcia, opinie, zdjęcia) wraz z danymi dostarczanymi przez LLM. Te dane generatywne zawierają zagregowane i podsumowane dane z LLM, które służą do wzbogacania danych już powiązanych z danym miejscem.

Na przykład standardowe wyszukiwanie tekstowe (nowe) z frazą „stacje ładowania EV” zwraca listę miejsc, które oferują ładowanie EV. Ten typ odpowiedzi jest odpowiedni, jeśli szukasz najbliższej ładowarki EV lub najbliższej ładowarki zgodnej z Twoim pojazdem.

Możesz też lepiej poznać okolicę stacji ładowania, zwłaszcza jeśli zamierzasz tam spędzić godzinę lub dłużej, podczas gdy pojazd się ładuje. Jeśli użyjesz funkcji modelu Gemini do tego samego wyszukiwania, odpowiedź może zawierać dynamiczne, generatywne opisy każdego miejsca w odpowiedzi, w tym informacje o pobliżu stacji ładowania:

  • „W odległości 2–4 minut spacerem znajduje się kilka restauracji i sklepów, takich jak Chef Chu's, Gen Korean BBQ House, Amber India, Pacific Catch oraz kilka sklepów spożywczych, takich jak Walmart, Whole Foods Market i Trader Joe's”.

  • „W odległości 1–5 minut spacerem znajduje się kilka restauracji i sklepów, w tym Khao Kang Thai Kitchen, Roger's Deli & Donuts i La Costeña. Jeśli chodzi o sushi, dobrym pomysłem jest Joy Sushi. W przypadku artykułów spożywczych Dollar Tree oferuje szeroki wybór produktów w obniżonych cenach”.

Treści generowane przez LLM wzbogacają odpowiedź i zawierają dodatkowe informacje, które pomagają użytkownikom podejmować świadome decyzje.

Dodaliśmy do interfejsu Places API nowe funkcje oparte na AI (nowość)

Te funkcje dodają do odpowiedzi interfejsu Places API (New) te dane:

Generatywne podsumowania miejsc

Generatywne podsumowania miejsc są powiązane z identyfikatorem miejsca. Podsumowania miejsc zbierają wiele różnych typów danych w jednym podsumowaniu.

Places API (nowość) udostępnia 2 typy generowanych podsumowań miejsc:

  • Podsumowania: krótkie podsumowanie informacji o miejscu (średnio około 100 znaków), które pomaga użytkownikom uzyskać ogólny obraz danego miejsca.

  • Podsumowania opisów: dłuższe podsumowania miejsca, średnio ok. 400 znaków, które zawierają szczegółowe informacje o jego najważniejszych cechach.

Podsumowania miejsc są obecnie dostępne w przypadku typów miejsc podanych w sekcji Obsługiwane typy w kategoriach Kultura, Rozrywka i rekreacja, Jedzenie i picie, Zakupy oraz Sport.

Generatywne podsumowania obszarów

Generatywna AI tworzy podsumowania obszarów dla pobliskiej okolicy miejsca. Podsumowanie obszaru może zawierać wszystkie informacje niezbędne użytkownikowi do podjęcia decyzji, bez konieczności wysyłania kolejnych żądań w celu uzyskania szczegółowych informacji o danym obszarze.

Oprócz opisu obszaru odpowiedź zawiera też listę identyfikatorów miejsc, do których odwołuje się opis, oraz listę miejsc posortowanych według różnych typów treści. Na przykład jeden typ treści zawiera listę miejsc związanych z atrakcjami w okolicy, a inny – listę restauracji w okolicy.

Podsumowania obszarów są obecnie dostępne w przypadku typów miejsc wyświetlanych w obsługiwanych typach w kategorii Noclegi, a także w przypadku typów miejsc electric_vehicle_charging_station, geocode i premise.

Generowanie podsumowań miejsc i obszarów

Zarówno podsumowania generowane przez generatywną usługę miejsc, jak i podsumowania generowane przez generatywną usługę obszaru są często generowane przez Google w trybie offline. Generując te podsumowania w trybie offline, możesz korzystać z treści generowanych przez Gemini, jednocześnie uzyskując oczekiwaną wydajność interfejsu Places API (New).

Google często odtwarza te podsumowania, aby były aktualne i oparte na najnowszych dostępnych informacjach. Oznacza to, że po wywołaniu interfejsu API wyświetlisz w swojej usłudze najnowsze dane.

Wyniki wyszukiwania kontekstowego

Wyszukiwanie tekstowe (Nowe) zwraca informacje o zestawie miejsc na podstawie ciągu znaków, na przykład „pizza w Krakowie” lub „sklepy obuwnicze w pobliżu Ottawy”. Odpowiedź na zapytanie tekstowe (nowa) zawiera listę miejsc pasujących do ciągu tekstowego oraz wszelkie ustawienia preferencji lokalizacji podane w żądaniu.

Gdy dodasz do odpowiedzi wyniki wyszukiwania kontekstowego, odpowiedź będzie zawierać opinie, zdjęcia i uzasadnienia, które pomogą użytkownikom odpowiedzieć na te pytania:

  • Dlaczego w wynikach widzę to miejsce?
  • Dlaczego warto wybrać to miejsce?

Na przykład wysyłasz żądanie do usługi Szczegóły miejsca (Nowa), wyszukiwania tekstowego (Nowa) lub wyszukiwania w pobliżu (Nowa), które zawiera w odpowiedzi określone miejsce. Dane odpowiedzi dotyczące tego miejsca są takie same we wszystkich 3 przypadkach, ponieważ zwrócone dane są powiązane z tym miejscem.

W przypadku zapytania tekstowego (Nowy) korzystającego z nowych funkcji odpowiedź może jednak zawierać dane pochodzące z samego ciągu zapytania wejściowego. Oznacza to, że wyniki wyszukiwania kontekstowego są unikalne dla ciągu zapytania. Na przykład wysyłasz żądanie wyszukiwania tekstowego (Nowe) z tym ciągiem znaków zapytania:

„Ostra wegetariańska restauracja w Mountain View w Kalifornii”

Następnie pozostawiasz wszystkie parametry wejściowe bez zmian i modyfikujesz tylko ciąg zapytania:

„Ostra wegetariańska restauracja w Mountain View w Kalifornii”

W przypadku restauracji, która pojawia się w obu odpowiedziach, dane o miejscu są takie same, ponieważ są powiązane z tym miejscem. Wyniki wyszukiwania kontekstowego są jednak unikalne dla zapytania, ponieważ pochodzą z łańcucha zapytania. Możesz wyświetlać użytkownikom opinie, zdjęcia i uzasadnienia z kontekstowych wyników wyszukiwania, aby pomóc im zdecydować, które miejsce w odpowiedzi najlepiej odpowiada ich zapytaniu.

Włączanie funkcji modelu Gemini w przypadku interfejsu Places API (nowość)

Aby korzystać z modeli Gemini w ramach interfejsu Places API (Nowy), musisz go włączyć. Więcej informacji znajdziesz w artykule o konfigurowaniu projektu Google Cloud.

Ograniczenia wersji eksperymentalnej

Ta wersja obsługuje tylko podsumowania miejsc i obszarów w Stanach Zjednoczonych w języku angielskim.

Co to jest Gemini?

Więcej informacji o modelu Gemini znajdziesz w artykule Najczęstsze pytania dotyczące Gemini.

Wysyłanie prośby o generowanie podsumowania

Podsumowania miejsc to generowane przez LLM generatywne podsumowania dotyczące określonego miejsca. Interfejs Places API (nowy) dodaje do odpowiedzi 2 rodzaje podsumowań:

  • Omówienie – generowane automatycznie podsumowania podobne do statycznych podsumowań redakcyjnych powiązanych z miejscem. Krótkie wygenerowane podsumowania, które mają średnio około 100 znaków, mają kilka zalet:

    • Wiele miejsc nie ma podsumowań redakcyjnych, więc uzupełniają one lukę w dostępnych informacjach.

    • Są one generowane na podstawie LLM, więc właściciel miejsca nie musi ich aktualizować.

  • Opis generowane podsumowania pochodzą z wielu źródeł, w tym z opinii z Map Google. Opis, który ma średnio około 400 znaków, zawiera listę opinii użytych do wygenerowania długiego opisu.

    Aby wygenerować podsumowania ręcznie, trzeba zebrać dane z wielu miejsc, a potem ręcznie utworzyć i utrzymywać treści. Funkcje modelu Gemini w przypadku interfejsu Places API (New) tworzą te podsumowania na podstawie modeli językowych, aby zachować zakres i aktualność generowanych treści.

Podsumowania miejsc są obsługiwane przez szczegóły miejsc (nowa funkcja), wyszukiwanie tekstowe (nowa funkcja) i wyszukiwanie w okolicy (nowa funkcja). Aby w odpowiedzi uwzględnić podsumowanie miejsca, w masce pola w żądaniu dodaj to pole:

  • Szczegóły miejsca: generativeSummary

  • Wyszukiwanie tekstowe i wyszukiwanie w pobliżu: places.generativeSummary

Pole generativeSummary zawiera te pola:

  • generativeSummary.overview: podsumowanie generative overview.
  • generativeSummary.description: generatywne podsumowanie opisu.
  • generativeSummary.references: tablica zawierająca do 5 opinii, które służą do wyświetlania treści w podsumowaniu opisu. Jeśli nie ma podsumowania opisu, tablica jest pusta.
  • overviewFlagContentUri: link, pod którym użytkownicy mogą zgłosić problem z podsumowaniem podsumowania.
  • descriptionFlagContentUri: link, w którym użytkownicy mogą zgłosić problem z podsumowaniem opisu.

Przykładowa prośba o podsumowanie podglądu i opisu

W tym przykładzie maska pola places.generativeSummary zwraca cały obiekt generativeSummary, w tym pola generativeSummary.overview, generativeSummary.description i generativeSummary.references:

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
https://places.googleapis.com/v1/places:searchText

Odpowiedź ma postać:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        },
        "description": {
          "text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
          Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
          available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
          seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
          "languageCode": "en-US"
        },
        "references": {
          "reviews": [
            {
              "name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
              "relativePublishTimeDescription": "12 months ago",
              "rating": 5,
              "text": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "John Smith",
                "uri": "https://www.google.com/maps/contrib/11685942231/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
              "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670"
            },
            . . .
          ]
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12",
        "descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12"
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
          "languageCode": "en-US"
        },
        . . .
}

Przykładowa prośba o podsumowanie

To przykładowe wyszukiwanie tekstowe zwraca tylko podsumowanie overview dotyczące pikantnych wegetariańskich restauracji w Mountain View w Kalifornii:

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary.overview" \
https://places.googleapis.com/v1/places:searchText

Odpowiedź zawiera pole generativeSummary.overview, które zawiera pola overview.text i overview.languageCode:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
          "languageCode": "en-US"
        }
      }
    },
  . . .
}

Wysyłanie prośby o podsumowanie obszaru generatywnego

Podsumowania obszarów to generowane przez model LLM podsumowania dotyczące pobliskiego obszaru miejsca. Podsumowania obszarów mogą być ważne dla użytkowników, którzy podejmują decyzję o wybraniu miejsca.

Chcesz np. zarezerwować pokój w hotelu w nowym mieście. Znajdujesz hotel, który spełnia Twoje wymagania, ale chcesz też dowiedzieć się więcej o okolicy. Zamiast oglądać mapę okolicznego obszaru i sprawdzać wszystkie miejsca na mapie, możesz wygenerować podsumowanie obszaru dla hotelu.

Podsumowania obszarów są obsługiwane przez szczegóły miejsca (nowa wersja), wyszukiwanie tekstowe (nowa wersja) i wyszukiwanie w okolicy (nowa wersja).

Aby w odpowiedzi uwzględnić podsumowanie obszaru, umieść w żądaniu maskę pola:

  • areaSummary (Szczegóły miejsca)
  • places.areaSummary (wyszukiwanie tekstowe i wyszukiwanie w pobliżu).

Pole areaSummary w przypadku miejsca w odpowiedzi zawiera pole flagContentUri, za pomocą którego możesz zgłosić nieodpowiednie treści, aby Google mogło je usunąć. Zawiera też tablicę z maksymalnie 4 contentBlocks. Temat każdego bloku zależy od typu miejsca:

  • W przypadku stacji ładowania pojazdów elektrycznych, zdefiniowanych jako miejsce typu electric_vehicle_charging_station, bloki tematyczne to: "overview", "coffee", "restaurant" i "store".

  • W przypadku miejsca o typie zdefiniowanym przez kategorię Noclegi oraz konkretne typy miejsc geocode i premise bloki tematyczne obejmują: "overview", "activity", "restaurant" i "store".

Przykład żądania informacji o obszarze na stacji ładowania EV

To przykładowe żądanie szczegółów miejsca zwraca podsumowanie obszaru dotyczące konkretnej stacji ładowania EV w Mountain View, zidentyfikowanej za pomocą identyfikatora miejsca: ChIJC5b6QKiwj4ARgn2EwlnJnWU:

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

Odpowiedź zawiera pole areaSummary, w tym tablicę contentBlocks:

  • Pole topic określa typ bloku treści. Ponieważ w tym przykładzie jest to stacja ładowania EV, 4 bloki treści to "overview", "coffee", "restaurant" i "store".

  • Pole content zawiera podsumowanie tego tematu, w tym kod języka.

  • Tablica references określa nazwy zasobów miejsc w formie places/PLACE_ID, które służą do wyświetlania treści w bloku treści.

{
  "id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "areaSummary": {
    "contentBlocks": [
      {
        "topic": "overview",
        "content": {
          "text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
          ]
        }
      },
      {
        "topic": "coffee",
        "content": {
          "text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
          ]
        }
      },
      {
        "topic": "restaurant",
        "content": {
          "text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
            "places/ChIJETHw0F-7j4AR85V_I6OobCI",
            "places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
            "places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
          ]
        }
      },
      {
        "topic": "store",
        "content": {
          "text": "Safeway provides a range of groceries, along with a deli and a bakery.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
          ]
        }
      }
    ],
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12"
  }
}

Przykładowe żądanie podsumowania obszaru dla hotelu

W tym przykładowym żądaniu wyszukiwania tekstu występują hotele w Mountain View w Kalifornii:

curl -X  POST -d '{
  "textQuery": "Hotels",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.areaSummary" \
https://places.googleapis.com/v1/places:searchText

Odpowiedź zawiera pole areaSummary oraz tablicę contentBlocks. Odpowiedź na miejsca typu Hotel zawiera bloki treści na tematy "overview", "activity", "restaurant" i "store":

{
  "places": [
    {
      "id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
      "displayName": {
        "text": "Shashi Hotel Mountain View, an Urban Resort",
        "languageCode": "en"
      },
      "areaSummary": {
        "contentBlocks": [
          {
            "topic": "overview",
            "content": {
              "text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJo4za6vi5j4ARMua093RgGGA",
                "places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
              ]
            }
          },
          {
            "topic": "activity",
            "content": {
              "text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
              ]
            }
          },
          {
            "topic": "restaurant",
            "content": {
              "text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
                "places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
                "places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
              ]
            }
          },
          {
            "topic": "store",
            "content": {
              "text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJh64-r0O3j4ARy1P41IH2j3k",
                "places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
              ]
            }
          }
        ],
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12"
      }
    },
    ...
  ]
}

Prośba o wyniki wyszukiwania kontekstowego

Odpowiedź na żądanie Wyszukiwanie tekstowe (nowe) zawiera tablicę miejsc pasujących do kryteriów podanego ciągu wyszukiwania. Teraz możesz poprosić o dane wyszukiwania kontekstowego w odpowiedzi na podstawie zapytania wejściowego przesłanego do interfejsu API.

Aby obsługiwać podsumowania kontekstowe, odpowiedź z wyszukiwania tekstowego (nowej wersji) zawiera nowy tablicę o nazwie contextualContents na tym samym poziomie co tablica places w odpowiedzi:

{
  "places": [],
  "contextualContents":[]
}

Każdy element w tablicy contextualContents typu ContextualContent znajduje się w odpowiedniej lokalizacji tablicy, tak jak miejsce w tablicy places. Oznacza to, że element contextualContents[0] odpowiada miejscu places[0].

Każdy element tablicy zawiera te pola tablicy:

  • contextualContents.reviews: tablica zawierająca maksymalnie 3 opinie.
  • contextualContents.photos: tablica zawierająca do 5 zdjęć.

  • contextualContents.justifications: tablica uzasadnień miejsca, w tym:

    • reviewJustification: wyróżnij sekcję opinii użytkownika, która może być interesująca dla użytkownika.
    • businessAvailabilityAttributesJustification: zawiera atrybuty firmy, które mogą zainteresować użytkownika.

Aby uwzględnić w odpowiedzi wyniki wyszukiwania kontekstowego, dodaj contextualContents do maski pola w prośbie wyszukiwania tekstowego (nowej):

curl -X  POST  -d '{
  "textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
  "openNow": true,
  "maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText

Odpowiedź zawiera tablicę contextualContents dla każdego miejsca w odpowiedzi:

{
  "places": [
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      }
    },
    . . .
  ],
  "contextualContents": [
    {
      "reviews": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
          "relativePublishTimeDescription": "a year ago",
          "rating": 5,
          "text": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
            the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
            enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset
            to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
            We enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Jane Doe",
            "uri": "https://www.google.com/maps/contrib/113193/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB",
          "relativePublishTimeDescription": "10 months ago",
          "rating": 5,
          "text": {
            "text": "This is a nice little spot to eat at. I'm a big fan of
            curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "This is a nice little spot to eat at. I'm a big fan of curries,
            and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Bob Jones",
            "uri": "https://www.google.com/maps/contrib/11034435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db"
        },
        . . .
      ],
      "photos": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
          "widthPx": 1920,
          "heightPx": 1080,
          "authorAttributions": [
            {
              "displayName": "A Google User",
              "uri": "//maps.google.com/maps/contrib/113010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db"
        },
        . . .
      ],
      "justifications": [
        {
          "reviewJustification": {
            "highlightedText": {
              "text": "\"Not too spicy or oily.\"",
              "highlightedTextRanges": [
                {
                  "startIndex": 9,
                  "endIndex": 14
                }
              ]
            },
            "review": {
              "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
              "relativePublishTimeDescription": "10 months ago",
              "rating": 5,
              "text": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "Stan Davis",
                "uri": "https://www.google.com/maps/contrib/112959/reviews",
                "photoUri": "https://lh3.googleuser-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z",
              "flagContentUri": "https://www.google.com/local/review/rap/report?postt=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

Wskazówki dotyczące implementacji w przypadku zastosowań motoryzacyjnych

Ze względu na bezpieczeństwo kierowców Google zaleca renderowanie podsumowań generatywnej AI w trybie zaparkowanego pojazdu. Jeśli podsumowania są renderowane w trybie jazdy, informacje na ekranie powinny być proste, przejrzyste i zwięzłe, aby kierowca mógł szybko wrócić do obserwowania drogi.

  • Nie więcej niż 3 wiersze
  • 120 znaków lub 24 słowa
  • Minimalny rozmiar z przodu: 24 dp

Szczególnie w kontekście motoryzacyjnym to deweloper odpowiada za renderowanie podsumowań generatywnej AI w sposób bezpieczny i zgodny ze wszystkimi lokalnymi przepisami i regulacjami prawnymi.

Atrybucje

Jeśli wyświetlasz w aplikacji opinie, zdjęcia i podsumowania generowane przez AI, w tym podsumowania miejsc i obszarów, musisz też wyświetlać wymagane informacje o źródle.

Wyświetlanie informacji o źródłach w przypadku podsumowań generowanych

Jeśli wyświetlasz w aplikacji podsumowania wygenerowane przez sztuczną inteligencję, w tym podsumowania miejsc i obszarów, musisz też wyświetlać niezbędne informacje o źródle. Z tej sekcji dowiesz się, jak wyświetlać informacje o autorze na podstawie sposobu wyświetlania w aplikacji podsumowań wygenerowanych przez generatywną AI.

W każdym przypadku atrybucja musi być zapisana z wielkości liter jak w zdaniu. Logo Google i informacje o atrybucji muszą być zgodne ze wszystkimi standardami dotyczącymi kolorów, stylu i króju pisma. Więcej informacji o tych standardach znajdziesz w zasadach dotyczących interfejsu Places API (nowej wersji).

Podsumowanie generatywnej AI wyświetlane w kontekście innych danych Google

W takim przypadku informacja o autorze generowanej przez AI treści może być wyświetlana samodzielnie nad lub pod podsumowaniem, a przypisywanie treści do Google może być widoczne w innym miejscu.

W przypadku informacji o autorze użyj tekstu „Podsumowanie przygotowane przez AI”, jak pokazano na tym obrazie:

W przypadku atrybucji użyj tekstu Podsumowano za pomocą AI.

Podsumowanie generatywnej AI wyświetlane osobno

Gdy podsumowanie generatywnej AI pojawia się bez innych treści z Map Google, musi zawierać zarówno informacje o generatywnej AI, jak i o Google, rozdzielone przecinkiem. W informacjach o źródle użyj tekstu „Summarized by AI” i logo Google, jak pokazano na tym obrazku:

Aby podsumowanie wyświetlać oddzielnie, uwzględnij atrybucję generatywnej AI i Google oddzielonych znakiem interpunkcji.

Podsumowanie generatywnej AI powtórzone na liście

Podczas powtarzania podsumowania miejsca wygenerowanego przez generatywną AI na liście miejsc, w której:

  • Zawartość listy jest przypisywana Google
  • Wyświetlane podsumowania są generowane przez AI.
  • Treści są dostępne od Google

Informacje o autorze utworu powinny być wyświetlane w jednym wierszu nad lub pod listą. Atrybucja AI jest wyrównana do lewej, a atrybucja Google – do prawej:

W przypadku listy wyświetl atrybucję nad lub pod listą na jednym wierszu.

Jeśli na liście są używane dłuższe podsumowania opisu wygenerowane przez generatywną AI, każde podsumowanie musi zawierać informacje o źródle (np. „Podsumowanie wygenerowane przez AI” z ikoną lub przyciskiem z informacjami).

Wyświetlanie informacji o streszczeniu wygenerowanym przez generatywną AI w dialogu

Oprócz podsumowania generowanego przez generatywną AI musisz udostępnić użytkownikom dialog wyświetlający informacje o podsumowaniu oraz link do zgłaszania problemów za pomocą unikalnego identyfikatora podsumowania zawartego w polu flagContentUri. Jeśli używasz podsumowania opisu generowanego przez generatywną AI, musisz podać informacje o źródłach, nazywanych plikami referencyjnymi.

Umożliw dostęp do tego okna, dodając ikonę informacji (jako element interakcji) w połączeniu z atrybucją AI (jak w wymienionych powyżej przykładach) oraz sprawiając, aby obszar atrybucji AI i ikona reagowały na naciśnięcie lub kliknięcie.

W przypadku generowanych podsumowań miejsc wyświetlaj:

Informacje Streszczenia miejsc generowane przez AI są tworzone na podstawie opinii w Google i innych danych.
Zgłoś problem Aby zgłosić Google problem z treścią podsumowania, użyj linku zawartego w polu flagContentUri.
Pliki referencyjne Oceny źródeł

Na przykład:

wyświetlanie informacji o streszczeniach wygenerowanych przez AI w dialogu;

W przypadku podsumowań generowanych obszarów wyświetlaj:

Informacje Podsumowania obszarów AI są generowane na podstawie opinii w Google i danych lokalnych.
Zgłoś problem Aby zgłosić Google problem z treścią podsumowania, użyj linku zawartego w polu flagContentUri.

Atrybucja podsumowania obszaru wyświetlania.