Gemini-Modellfunktionen für die Places API

Die Gemini-Modellfunktionen für die Places API (New) unterstützen LLMs in die Places API, damit Sie die mit einem Ort verknüpften Daten zurückgeben können. (Öffnungszeiten, Rezensionen, Fotos) sowie Daten, die von LLMs bereitgestellt werden. Dieses Generative Daten enthalten aggregierte und zusammengefasste Daten aus den LLMs, um die Daten, die bereits mit einem Ort verknüpft sind.

Beispiel: Eine Standard- Textsuche (neu) für „Ladestationen für Elektrofahrzeuge“ gibt eine Liste von Orten zurück, die Ladestationen für Elektrofahrzeuge anbieten. Dieses wenn ihr nur nach einem Ladegerät für Elektrofahrzeuge sucht oder die am nächsten für Ihr Fahrzeug geeignet ist.

Vielleicht möchten Sie aber auch die Umgebung des Ladestation ein, vor allem, wenn Sie eine Stunde oder länger dort sein werden, während dein Fahrzeug lädt. Wenn Sie dafür die Funktionen des Gemini-Modells die gleiche Suchanfrage enthalten, kann die Antwort jeweils dynamische, generative Beschreibungen enthalten. Platz in der Antwort, einschließlich Informationen über den Bereich um das Ladekabel Station:

  • "Im Umkreis von 2 bis 4 Gehminuten gibt es mehrere Restaurants und Geschäfte. Optionen wie „Chef Chu's“, „Gen Korean BBQ House“, „Amber India“, „Pacific“ Fangen und mehrere Lebensmittelgeschäfte wie Walmart, Whole Foods Market das von Trader Joe.“

  • "Im Umkreis von 1–5 Gehminuten gibt es mehrere Restaurants und Geschäfte. Restaurants wie Khao Kang Thai Kitchen, Roger's Deli und Donuts und La Costeña. Sushi wird in Joy Sushi angeboten. Für Lebensmittel: Dollar Tree eine Vielzahl von Produkten zu reduzierten Preisen anbietet.“

Diese generativen Inhalte der LLMs verbessern die Reaktion und liefern zusätzliche Informationen, die Nutzenden helfen, eine fundierte Entscheidung zu treffen.

Neue KI-basierte Funktionen in Places API (neu)

Diese Funktionen fügen einer Places API (New)-Antwort die folgenden Daten hinzu:

  • Generative Ortszusammenfassungen, die sich auf einen bestimmten Ort beziehen place sein. Ortszusammenfassungen werden unterstützt von Place Details (New) Text Search (New), und Nearby Search (New).

  • Generierte Zusammenfassungen von Gebieten, die sich auf ein bestimmtes Gebiet beziehen um einen Ort herum. Bereichszusammenfassungen werden unterstützt von Place Details (New) Text Search (New), und Nearby Search (New).

  • Ergebnisse der Kontextsuche werden unterstützt von: Text Search (Neu) und Daten enthalten, die auf dem in der Anfrage übergebenen Suchstring basieren. direkt mit einem Ort verknüpft sind. Diese Daten helfen zu verstehen, Mit „Text Search (New)“ wird die Antwort bestimmt.

KI-generierte Ortszusammenfassungen

Generative Ortszusammenfassungen sind spezifisch für eine Orts-ID. Zusammenfassungen von Orten verschiedene Arten von Daten zu einer einzigen Zusammenfassung für den Ort zusammenfassen.

Die Places API (New) bietet zwei Arten von mit generativer Zusammenfassungen erstellten Orten:

  • Übersichten: kurze Übersicht über einen Ort, durchschnittlich um etwa 100 Zeichen, die Nutzern helfen können, sich einen Eindruck von einem Ort zu verschaffen.

  • Zusammenfassungen von Beschreibungen: Längere Zusammenfassungen eines Ortes, durchschnittlich etwa 400 Zeichen, die einen detaillierten Überblick über die wichtigsten Aspekte des Ortes.

Ortszusammenfassungen sind derzeit für Ortstypen verfügbar, die unter Unterstützte Typen für die Kategorien Kultur, Unterhaltung und Freizeit, Essen und Trinken, Shopping, und Sport.

Zusammenfassungen von KI-generierten Gebieten

Generative Gebietszusammenfassungen werden vom LLM für das nahegelegene Gebiet um ein Die Gebietszusammenfassung für einen Ort kann alle erforderlichen Informationen enthalten, damit der Nutzer eine Entscheidung treffen kann, ohne dass er weitere Anfragen stellen muss. um Details zu einem Gebiet aufzuschlüsseln.

Zusammen mit einer Beschreibung des Gebiets enthält die Antwort auch eine Liste von Orts-IDs für die Orte, auf die in der Beschreibung verwiesen wird, und eine Liste von Orten die nach verschiedenen Inhaltstypen sortiert sind. Ein Inhaltstyp enthält beispielsweise von Orten, die mit Aktivitäten in diesem Gebiet verbunden sind, und ein anderer enthält eine Liste mit Restaurants in der Umgebung.

Zusammenfassungen sind derzeit für Ortstypen verfügbar, die in Unterstützte Typen für die Kategorie Unterkünfte sowie für die jeweiligen Ortstypen electric_vehicle_charging_station, geocode und premise.

Erstellen von Orts- und Gebietszusammenfassungen

Sowohl die Zusammenfassungen der generativen Ortsbeschreibungen als auch die Zusammenfassungen von generativen Gebieten die häufig offline von Google generiert wurden. Wenn Sie diese Zusammenfassungen offline generieren, kannst du die von Gemini bereitgestellten Inhalte nutzen und gleichzeitig die dieselbe Leistung wie mit der Places API (New) erzielen, die Sie bereits erwarten.

Diese Zusammenfassungen werden von Google regelmäßig neu erstellt, damit sie aktuell sind basierend auf den neuesten verfügbaren Informationen. Das bedeutet, dass Sie Daten in Ihrem Dienst aktualisiert, wenn Sie die API aufrufen.

Kontextbezogene Suchergebnisse

„Text Search (New)“ gibt Informationen über mehrere Orte basierend auf einem String zurück. – zum Beispiel "pizza in new york" oder „Schuhgeschäfte in der Nähe von Hamburg“. Text Search Die (New)-Antwort enthält eine Liste von Orten, die mit der Textzeichenfolge und allen die in der Anfrage festgelegte Standortgewichtung.

Wenn Sie der Antwort kontextbezogene Suchergebnisse hinzufügen, fügen Sie Rezensionen, Fotos und Begründungen hinzu, die den Nutzern helfen, Fragen:

  • Warum wird dieser Ort in den Ergebnissen angezeigt?
  • Warum sollte ich mich für diesen Ort entscheiden?

Beispiel: Sie stellen eine Anfrage an „Place Details (New)“, „Text Search (New)“ oder „Nearby Search (New)“, die einen bestimmten Ort in die Antwort einschließt. Die für den Ort für alle drei Anfragen gleich sind, zurückgegebenen Daten mit diesem Ort verknüpft sind.

Bei einer „Text Search (New)“ mit den neuen Funktionen kann die Antwort jedoch Daten einschließen, die aus dem Eingabeabfragestring selbst abgeleitet wurden. Das bedeutet, dass die kontextbezogene Suchergebnisse sind einzigartig für den Abfragestring. Zum Beispiel stellen Sie Eine „Text Search (New)“-Anfrage mit dem folgenden Abfragestring:

„Scharfes vegetarisches Restaurant in Mountain View, Kalifornien“

Dann lassen Sie alle Eingabeparameter unverändert und ändern nur den Abfragestring. in:

„Spicy vegan Restaurant in Mountain View, CA, USA“

Für ein Restaurant, das in beiden Antworten vorkommt, werden die Antwortdaten „place“ ist identisch, da die Daten mit dem Ort selbst verknüpft sind. Die kontextbezogene Suchergebnisse sind für die Suchanfrage einzigartig, da sie auf Abfragestring. Anschließend können Sie die Rezensionen, Fotos und Begründungen aus den kontextbezogenen Suchergebnissen an Ihre Nutzer richten, damit sie um zu entscheiden, welcher Ort in der Antwort am besten auf die Suchanfrage des Nutzers zutrifft.

Gemini-Modellfunktionen für Places API aktivieren (Neu)

Sie müssen die Places API (New) aktivieren, um die Gemini-Modellfunktionen verwenden zu können für Places API (New). Weitere Informationen finden Sie unter Richten Sie Ihr Google Cloud-Projekt ein.

Einschränkungen für den experimentellen Release

Diese Version unterstützt nur Zusammenfassungen von Orten und Gebieten für Orte in den USA. Bundesländer sind nur auf Englisch verfügbar.

Was ist Gemini?

Weitere Informationen zum Gemini-Modell finden Sie unter Gemini FAQs.

KI-generierte Ortszusammenfassung anfordern

Ortszusammenfassungen sind generative Zusammenfassungen, die vom LLM für ein bestimmtes Places API (New) fügt zwei Arten von Zusammenfassungen zu Antworten hinzu:

  • Übersicht: Generative Zusammenfassungen, die den statischen redaktionellen Inhalten ähneln die mit einem Ort verknüpft sind. Durchschnittliche generative Kurzzusammenfassungen Etwa 100 Zeichen, hat mehrere Vorteile:

    • Viele Anbieter haben keine redaktionellen Zusammenfassungen und füllen daher die Lücke in den Informationen zu einem Ort.

    • Sie werden vom LLM generiert, sodass der Ortsinhaber nicht benötigt wird. um sie zu verwalten.

  • Die generativen Zusammenfassungen für Beschreibungen stammen aus vielen Quellen, einschließlich Rezensionen aus Google Maps. Die Beschreibung hat durchschnittlich Zeichen, enthält eine Liste mit Beurteilungen, die zur Erstellung des langen Beschreibung.

    Um Zusammenfassungen von Beschreibungen manuell zu erstellen, muss eine Person Daten von vielen Standorten abrufen und die Inhalte dann handwerklich erstellen und pflegen. Gemini-Modellfunktionen für die Places API (New) erstellen diese Zusammenfassungen von den LLMs erhalten, um den Umfang und die Aktualität der generierten Inhalte zu gewährleisten.

Ortszusammenfassungen werden unterstützt von Place Details (New) Text Search (New), und Nearby Search (New). Um die Ortszusammenfassung in die Antwort aufzunehmen, fügen Sie das folgende Feld in die Feldmaske der Anfrage:

  • Place Details (Ortsdetails): generativeSummary

  • Text Search und Nearby Search: places.generativeSummary

Die generativeSummary enthält die folgenden Felder:

  • generativeSummary.overview: Die Zusammenfassung der generativen Übersicht.
  • generativeSummary.description: Die Zusammenfassung der generativen Beschreibung.
  • generativeSummary.references: Ein Array mit bis zu fünf Rezensionen, die für und geben Inhalte für die Zusammenfassung an. Wenn keine Beschreibung vorhanden ist ist dieses Array leer.

Beispiel für eine Anfrage mit einer Übersichtszusammenfassung

In diesem Beispiel gibt „Text Search“ nur die Zusammenfassung overview für „Scharf“ zurück. vegetarische Restaurants in Mountain View, Kalifornien:

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

Die Antwort enthält das Feld generativeSummary.overview mit dem Parameter overview.text und 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"
        }
      }
    },
  . . .
}

Beispiel für eine Anfrage mit einer Übersicht und Beschreibung

In diesem Beispiel wird dieselbe Abfrage wie im vorherigen Beispiel durchgeführt, es wird jedoch ein Feldmaske von places.generativeSummary, um die gesamte generativeSummary-Objekt, einschließlich generativeSummary.overview, generativeSummary.description und generativeSummary.references:

{
  "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": "Anam Qureshi",
                "uri": "https://www.google.com/maps/contrib/116859422317024657778/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1dl9FTSmec0x00000000-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
            },
            . . .
          ]
        }
      }
    },
    {
      "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"
        },
        . . .
}

Zusammenfassung der KI-generierten Bereiche anfordern

Bereichszusammenfassungen sind generative Zusammenfassungen, die vom LLM für die nähere Umgebung erstellt werden. eines Ortes. Zusammenfassungen von Bereichen können für die Entscheidung eines Nutzers

Angenommen, Sie möchten ein Hotel in einer neuen Stadt buchen und können ein Hotel finden, das Ihren Anforderungen entspricht, möchten Sie auch zur Umgebung des Hotels. Anstatt sich eine Karte der umgebenden und dann jeden Ort auf der Karte untersuchen müssen, können Sie stattdessen Bereichszusammenfassung für das Hotel generieren.

Bereichszusammenfassungen werden unterstützt von Place Details (New) Text Search (New), und Nearby Search (New).

Um die Bereichszusammenfassung in die Antwort aufzunehmen, fügen Sie Feldmaske der Anfrage:

  • areaSummary (Ortsdetails)
  • places.areaSummary (Text Search und Nearby Search).

Die areaSummary für einen Ort in der Antwort enthält ein Array mit bis zu vier contentBlocks Das Thema der einzelnen Blöcke richtet sich nach dem Typ des Ortes:

  • Für eine Ladestation für Elektrofahrzeuge, definiert als Ort electric_vehicle_charging_station, umfassen folgende Themenblöcke: "overview", "coffee", "restaurant" und "store".

  • Für einen Ort mit einem durch den Unterkunft Kategorie und die Ortstypen geocode und premise, das Thema Blöcke umfassen: "overview", "activity", "restaurant" und "store".

Beispielanfrage für eine Zusammenfassung der Fläche einer Ladestation für Elektrofahrzeuge

Dieses Beispiel für eine „Place Details“-Anfrage gibt die Gebietszusammenfassung für ein bestimmtes Elektrofahrzeug zurück Ladestation in Mountain View mit der Orts-ID 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

Die Antwort enthält das Feld areaSummary, einschließlich contentBlocks Array:

  • Im Feld topic wird die Art des Inhaltsblocks angegeben. Da der Ort in Beispiel für eine Ladestation für Elektrofahrzeuge. Die vier Inhaltsblöcke sind "overview", "coffee", "restaurant" und "store".

  • Das Feld content enthält die Zusammenfassung zu diesem Thema, einschließlich der Sprachcode.

  • Das Array references gibt die Namen der Ortsressourcen in der Form an places/PLACE_ID, verwendet zur Bereitstellung von Inhalten für den Content-Block.

{
  "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"
          ]
        }
      }
    ]
  }
}

Beispiel für eine Anfrage nach einer Zusammenfassung der Region für ein Hotel

In diesem Beispiel für eine Text Search-Anfrage werden Hotels in Mountain View, Kalifornien, USA, angefordert:

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

Die Antwort enthält das Feld areaSummary, einschließlich contentBlocks Array. Die Antwort für Orte des Typs Hotel enthält Inhaltsblöcke für die Themen "overview", "activity", "restaurant" und "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"
              ]
            }
          }
        ]
      }
    },
    ...
  ]
}

Kontextbezogene Suchergebnisse anfordern

Die Antwort auf eine Textsuche (neu) -Anfrage enthält ein Array von Orten, die den Kriterien der eingegebenen Suche entsprechen . Sie können jetzt Daten für die kontextbezogene Suche in der Antwort basierend auf dem Eingabeabfrage an die API.

Damit kontextbezogene Zusammenfassungen unterstützt werden, muss die Antwort der Textsuche (neu) enthält ein neues Array mit dem Namen contextualContents auf derselben Ebene wie die places-Array in der Antwort:

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

Jedes Element im contextualContents-Array des Typs ContextualContent, befindet sich am entsprechenden Array-Standort als Stelle im places-Array. Das lautet, dass das Element unter contextualContents[0] dem Ort an der places[0].

Jedes Array-Element enthält die folgenden Array-Felder:

  • contextualContents.reviews: ein Array mit bis zu drei Rezensionen.
  • contextualContents.photos: ein Array von bis zu fünf Fotos.
  • contextualContents.justifications: ein Array von Begründungen für den Ort, einschließlich:

    • reviewJustification: Markieren Sie ein einer Nutzerrezension, die für den Endnutzer von Interesse sein könnte.
    • businessAvailabilityAttributesJustification: Enthält Attribute für ein Unternehmen, das für Unternehmen interessant sein könnte Nutzer.

Um die kontextbezogenen Suchergebnisse in die Antwort aufzunehmen, fügen Sie contextualContents im Feldmaske der Anfrage „Text Search (New)“:

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

Die Antwort enthält das Array contextualContents für jeden Ort im Antwort:

{
  "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": "Guillaume Riesen",
            "uri": "https://www.google.com/maps/contrib/1131462893/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwG_WXt1SjB1rJg=s128-c-c0x00000000-cc-rp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSUNKZzlhTG53RRAB",
          "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": "Paul Sacks",
            "uri": "https://www.google.com/maps/contrib/1106671734435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9sVQ=s128-c-c0x00000000-cc-rp-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z"
        },
        . . .
      ],
      "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/113209927655010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgycOLDgOqPRYhzJ0EJlBFyKo9OrmacOo3C5YvrtR4Q=s100-p-k-no-mo"
            }
          ]
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9YNzyjkjDMD15gyobIQtIYg1GFPy3BdQHAaA3iNwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ]
        },
        . . .
      ],
      "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": "Harpal Kochar",
                "uri": "https://www.google.com/maps/contrib/1166232959/reviews",
                "photoUri": "https://lh3.googleusercoEnzB1zdrNbR00000-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

Implementierungsleitfaden für Anwendungsfälle der Automobilbranche

Für die Fahrsicherheit empfiehlt Google, Zusammenfassungen basierend auf generativer KI in geparkt sind. Beim Rendern von Zusammenfassungen im Fahrmodus Informationen auf dem Bildschirm sollten einfach, klar und prägnant sein, wird die Aufmerksamkeit des Fahrers schnell wieder auf die Straße gelenkt.

  • Nicht mehr als 3 Zeilen
  • Maximal 120 Zeichen oder 24 Wörter
  • Mindestgröße der Vorderseite: 24 dp

Insbesondere im Automobilkontext sind die Entwickler dafür verantwortlich, Zusammenfassungen mit generativer KI auf sichere und konforme Weise rendern lokale Gesetze und Bestimmungen.

Attribution

Wenn Sie Rezensionen, Fotos und Zusammenfassungen mit generativer KI in Ihrer App anzeigen, einschließlich Übersichten für Orte und Gebiete, müssen Sie auch die erforderlichen Quellenangaben.

Quellenangaben für generative Zusammenfassungen anzeigen

Wenn Sie auf generativer KI basierende Zusammenfassungen in Ihrer App anzeigen, einschließlich Ort und Bereich Zusammenfassungen anzuzeigen, müssen Sie auch die erforderlichen Quellenangaben anzeigen. Dieser Abschnitt wird beschrieben, wie Attributionen auf Grundlage der Darstellung der generativen KI angezeigt werden. Zusammenfassungen in deiner App.

In allen Fällen muss für die Quellenangabe die korrekte Groß- und Kleinschreibung des Satzes verwendet werden. Die Zuordnung und Das Google-Logo muss allen Farb-, Stil- und Schriftartstandards entsprechen. Weitere Informationen Informationen zu diesen Standards finden Sie unter Richtlinien für Places API (New)

Zusammenfassung der generativen KI, die im Kontext anderer Google-Daten angezeigt wird

In diesem Fall kann die Generative-AI-Attribution allein über oder unter der Zusammenfassung unter Berücksichtigung der Quellenangaben von Google für die Inhalte an anderer Stelle.

Verwenden Sie für die Attribution den Text „Zusammengefasst durch KI“. wie in dieser Abbildung gezeigt:

Verwenden Sie für die Zuordnung den Text „Von KI zusammengefasst“.

Zusammenfassung der generativen KI isoliert angezeigt

Wenn eine Zusammenfassung mit generativer KI isoliert von anderen Inhalten aus Google Maps zugeordnet ist, muss sie sowohl die generative KI-Attribution als auch die Attribution Google durch einen Kreuzungspunkt getrennt. Verwenden Sie für die Zuordnung den Text „Zusammengefasste durch KI“ und das Google-Logo, wie in diesem Bild:

Fügen Sie für isolierte Zusammenfassungen die Attribution der generativen KI und
  Google-Attribution, getrennt durch einen Punkt

Zusammenfassung der generativen KI in einer Liste wiederholt

Beim Wiederholen einer generativen KI Ortszusammenfassung in einer Liste von Orten, Dabei gilt:

  • Listeninhalt ist Google zugeordnet
  • Die angezeigten Zusammenfassungen sind KI-generiert
  • Inhalte sind bei Google verfügbar

Die Quellenangabe sollte in einer Zeile oberhalb oder unterhalb der Liste angezeigt werden. Die KI-Zuordnung ist links ausgerichtet und die Google-Attribution ist rechts ausgerichtet:

Bei Listen: Zeigen Sie die Quellenangaben über oder unter der Liste in einer einzelnen Zeile an.

Bei längeren Zusammenfassungen der generativen KI in einer Liste verwendet werden, muss jede Zusammenfassung KI-basierte Attribution („Summarized by AI“ mit dem Infosymbol bzw. der Infoschaltfläche).

Informationen zu einer Zusammenfassung mit generativer KI in einem Dialogfeld anzeigen

Neben einer Zusammenfassung mit generativer KI müssen Sie zum Abschluss einen Dialog zur Verfügung stellen mit Informationen zur Zusammenfassung und einem Link, über den Sie Probleme melden können. Bei Verwendung einer generativen KI description summary (Zusammenfassung der Beschreibung) müssen Informationen enthalten, zu den Quellen der Zusammenfassung, den Referenzen.

Zugriff auf dieses Dialogfeld durch Einfügen eines Infosymbols als Interaktivität ermöglichen Angebot) in Verbindung mit KI-Attribution (wie oben dargestellt) Beispiele) und dafür sorgen, dass der Bereich und das Symbol für die KI-Zuordnung auf eine klicken/drücken.

Zeige für KI-generierte Ortszusammenfassungen Folgendes an:

Info KI-generierte Ortszusammenfassungen werden aus Google-Rezensionen und anderen Quellen generiert Daten.
Problem melden Wenn Sie Google ein Problem mit dem Inhalt einer Zusammenfassung melden möchten, finden Sie hier.
Verweise Quellenrezensionen

Beispiel:

Informationen zu einer Zusammenfassung mit generativer KI in einem Dialogfeld anzeigen.

Für Zusammenfassungen generierter Bereiche Folgendes anzeigen:

Info KI-generierte Gebietszusammenfassungen werden anhand von Google-Rezensionen und lokalen Daten generiert.
Problem melden Wenn Sie Google ein Problem mit dem Inhalt einer Zusammenfassung melden möchten, finden Sie hier.

Zusammenfassung der Zuordnung des Anzeigebereichs.