Tokëzimi me Google Maps

Bazimi me Google Maps lidh aftësitë gjeneruese të Gemini me të dhënat e pasura, faktike dhe të azhurnuara të Google Maps. Kjo veçori u mundëson zhvilluesve të përfshijnë lehtësisht funksionalitetin e ndërgjegjshëm për vendndodhjen në aplikacionet e tyre. Kur një pyetje e përdoruesit ka një kontekst të lidhur me të dhënat e Maps, modeli Gemini shfrytëzon Google Maps për të ofruar përgjigje faktike të sakta dhe të freskëta që janë relevante për vendndodhjen ose zonën e përgjithshme të specifikuar nga përdoruesi.

• Përgjigje të sakta dhe të vetëdijshme për vendndodhjen: Shfrytëzoni të dhënat e gjera dhe të azhurnuara të Google Maps për pyetje specifike gjeografikisht.
• Personalizim i përmirësuar: Përshtatni rekomandimet dhe informacionin bazuar në vendndodhjet e ofruara nga përdoruesi.
• Informacion kontekstual dhe widget-e: Shenja kontekstuale për të paraqitur widget-e interaktive të Google Maps së bashku me përmbajtjen e gjeneruar.

Filloni

Ky shembull demonstron se si të integroni Grounding me Google Maps në aplikacionin tuaj për të ofruar përgjigje të sakta dhe të vetëdijshme për vendndodhjen ndaj pyetjeve të përdoruesit. Kërkesa kërkon rekomandime lokale me një vendndodhje opsionale të përdoruesit, duke i mundësuar modelit Gemini të shfrytëzojë të dhënat e Google Maps.

from google import genai
from google.genai import types

client = genai.Client()

prompt = "What are the best Italian restaurants within a 15-minute walk from here?"

response = client.models.generate_content(
    model='gemini-2.5-flash-lite',
    contents=prompt,
    config=types.GenerateContentConfig(
        # Turn on grounding with Google Maps
        tools=[types.Tool(google_maps=types.GoogleMaps())],
        # Optionally provide the relevant location context (this is in Los Angeles)
        tool_config=types.ToolConfig(retrieval_config=types.RetrievalConfig(
            lat_lng=types.LatLng(
                latitude=34.050481, longitude=-118.248526))),
    ),
)

print("Generated Response:")
print(response.text)

if grounding := response.candidates[0].grounding_metadata:
  if grounding.grounding_chunks:
    print('-' * 40)
    print("Sources:")
    for chunk in grounding.grounding_chunks:
      print(f'- [{chunk.maps.title}]({chunk.maps.uri})')

import { GoogleGenAI } from "@google/gnai";

const ai = new GoogleGenAI({});

async function generateContentWithMapsGrounding() {
  const response = await ai.models.generateContent({
    model: "gemini-2.5-flash",
    contents: "What are the best Italian restaurants within a 15-minute walk from here?",
    config: {
      // Turn on grounding with Google Maps
      tools: [{ googleMaps: {} }],
      toolConfig: {
        retrievalConfig: {
          // Optionally provide the relevant location context (this is in Los Angeles)
          latLng: {
            latitude: 34.050481,
            longitude: -118.248526,
          },
        },
      },
    },
  });

  console.log("Generated Response:");
  console.log(response.text);

  const grounding = response.candidates[0]?.groundingMetadata;
  if (grounding?.groundingChunks) {
    console.log("-".repeat(40));
    console.log("Sources:");
    for (const chunk of grounding.groundingChunks) {
      if (chunk.maps) {
        console.log(`- [${chunk.maps.title}](${chunk.maps.uri})`);
      }
    }
  }
}

generateContentWithMapsGrounding();

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent' \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: ${GEMINI_API_KEY}" \
  -d '{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "What are the best Italian restaurants within a 15-minute walk from here?"
    }]
  }],
  "tools": [{"googleMaps": {}}],
  "toolConfig": {
    "retrievalConfig": {
      "latLng": {"latitude": 34.050481, "longitude": -118.248526}
    }
  }
}'

Si funksionon Tokëzimi me Google Maps

Tokëzimi me Google Maps integron Gemini API me ekosistemin Google Geo duke përdorur Maps API si burim tokëzimi. Kur pyetja e një përdoruesi përmban kontekst gjeografik, modeli Gemini mund të aktivizojë mjetin "Tokëzimi me Google Maps". Modeli më pas mund të gjenerojë përgjigje të bazuara në të dhënat e Google Maps që lidhen me vendndodhjen e dhënë.

Procesi zakonisht përfshin:

1. Pyetje nga përdoruesi: Një përdorues i paraqet një pyetje aplikacionit tuaj, duke përfshirë potencialisht kontekstin gjeografik (p.sh., "kafene pranë meje", "muze në San Francisko").
2. Thirrja e mjetit: Modeli Gemini, duke njohur qëllimin gjeografik, thirr mjetin Grounding with Google Maps. Ky mjet mund të pajiset opsionalisht me latitude dhe longitude të përdoruesit për rezultate të ndërgjegjshme për vendndodhjen.
3. Marrja e të dhënave: Shërbimi Grounding with Google Maps kërkon informacion përkatës në Google Maps (p.sh., vende, vlerësime, foto, adresa, orare hapjeje).
4. Gjenerimi i bazuar: Të dhënat e marra të Hartave përdoren për të informuar përgjigjen e modelit Gemini, duke siguruar saktësi dhe rëndësi faktike.
5. Përgjigja dhe shenja e widget-it: Modeli kthen një përgjigje tekstuale, e cila përfshin citime nga burimet e Google Maps. Opsionale, përgjigja e API-t mund të përmbajë edhe një google_maps_widget_context_token , duke u lejuar zhvilluesve të paraqesin një widget kontekstual të Google Maps në aplikacionin e tyre për ndërveprim vizual.

Pse dhe kur duhet të përdoret Grounding me Google Maps

Bazimi me Google Maps është ideal për aplikacionet që kërkojnë informacion të saktë, të azhurnuar dhe specifik për vendndodhjen. Ai përmirëson përvojën e përdoruesit duke ofruar përmbajtje relevante dhe të personalizuar të mbështetur nga baza e të dhënave e gjerë e Google Maps me mbi 250 milionë vende në të gjithë botën.

Duhet të përdorni Grounding me Google Maps kur aplikacioni juaj ka nevojë të:

• Jepni përgjigje të plota dhe të sakta për pyetje gjeografike.
• Ndërtoni planifikues udhëtimesh dhe guida lokale që të flasin me njëri-tjetrin.
• Rekomandoni pika interesi bazuar në vendndodhjen dhe preferencat e përdoruesit, si restorante ose dyqane.
• Krijoni përvoja të ndërgjegjshme për vendndodhjen për shërbimet sociale, të shitjes me pakicë ose të shpërndarjes së ushqimit.

Përdorimi i Google Maps shkëlqen në rastet e përdorimit ku afërsia dhe të dhënat aktuale faktike janë kritike, siç është gjetja e "kafenesë më të mirë pranë meje" ose marrja e udhëzimeve.

Metodat dhe parametrat e API-t

Tokëzimi me Google Maps ekspozohet përmes Gemini API si një mjet brenda metodës generateContent . Ju aktivizoni dhe konfiguroni Tokëzimin me Google Maps duke përfshirë një objekt googleMaps në parametrin tools të kërkesës suaj.

{
  "contents": [{
    "parts": [
      {"text": "Restaurants near Times Square."}
    ]
  }],
  "tools":  { "googleMaps": {} }
}

Mjeti googleMaps mund të pranojë gjithashtu një parametër boolean enableWidget , i cili përdoret për të kontrolluar nëse fusha googleMapsWidgetContextToken kthehet në përgjigje. Kjo mund të përdoret për të shfaqur një vegël kontekstuale të Places .

{
"contents": [{
    "parts": [
      {"text": "Restaurants near Times Square."}
    ]
  }],
  "tools":  { "googleMaps": { "enableWidget": true } }
}

Për më tepër, mjeti mbështet kalimin e vendndodhjes kontekstuale si toolConfig .

{
  "contents": [{
    "parts": [
      {"text": "Restaurants near here."}
    ]
  }],
  "tools":  { "googleMaps": {} },
  "toolConfig":  {
    "retrievalConfig": {
      "latLng": {
        "latitude": 40.758896,
        "longitude": -73.985130
      }
    }
  }
}

Kuptimi i përgjigjes së tokëzimit

Kur një përgjigje bazohet me sukses me të dhënat e Google Maps, përgjigjja përfshin një fushë groundingMetadata . Këto të dhëna të strukturuara janë thelbësore për verifikimin e pretendimeve dhe ndërtimin e një përvoje të pasur me citime në aplikacionin tuaj, si dhe për përmbushjen e kërkesave të përdorimit të shërbimit.

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "CanteenM is an American restaurant with..."
          }
        ],
        "role": "model"
      },
      "groundingMetadata": {
        "groundingChunks": [
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=13100894621228039586",
              "title": "Heaven on 7th Marketplace",
              "placeId": "places/ChIJ0-zA1vBZwokRon0fGj-6z7U"
            },
            // repeated ...
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "startIndex": 0,
              "endIndex": 79,
              "text": "CanteenM is an American restaurant with a 4.6-star rating and is open 24 hours."
            },
            "groundingChunkIndices": [0]
          },
          // repeated ...
        ],
        "webSearchQueries": [
          "restaurants near me"
        ],
        "googleMapsWidgetContextToken": "widgetcontent/..."
      }
    }
  ]
}

API-ja Gemini kthen informacionin e mëposhtëm me groundingMetadata :

• groundingChunks : Matricë objektesh që përmbajnë burimet e maps ( uri , placeId dhe title ).
• groundingSupports : Matricë chunk-esh për të lidhur tekstin e përgjigjes së modelit me burimet në groundingChunks . Çdo chunk lidh një hapësirë ​​teksti (të përcaktuar nga startIndex dhe endIndex ) me një ose më shumë groundingChunkIndices . Ky është çelësi për ndërtimin e citimeve brenda rreshtit.
• googleMapsWidgetContextToken : Një shenjë teksti që mund të përdoret për të paraqitur një vegël kontekstuale të Places .

Për një fragment kodi që tregon se si të paraqiten citimet brenda tekstit, shihni shembullin në dokumentet Grounding with Google Search.

Shfaq miniaplikacionin kontekstual të Hartave Google

Për të përdorur googleMapsWidgetContextToken të kthyer, duhet të ngarkoni API-n JavaScript të Google Maps .

Rastet e përdorimit

Tokëzimi me Google Maps mbështet një sërë rastesh përdorimi të ndërgjegjshme për vendndodhjen. Shembujt e mëposhtëm demonstrojnë se si kërkesa dhe parametra të ndryshëm mund të shfrytëzojnë Tokëzimin me Google Maps. Informacioni në Rezultatet e Tokëzimit të Google Maps mund të ndryshojë nga kushtet aktuale.

Trajtimi i pyetjeve specifike për vendin

Bëni pyetje të hollësishme rreth një vendi specifik për të marrë përgjigje bazuar në vlerësimet e përdoruesve të Google dhe të dhëna të tjera të Maps.

from google import genai
from google.genai import types

client = genai.Client()

prompt = "Is there a cafe near the corner of 1st and Main that has outdoor seating?"

response = client.models.generate_content(
    model='gemini-2.5-flash-lite',
    contents=prompt,
    config=types.GenerateContentConfig(
        # Turn on the Maps tool
        tools=[types.Tool(google_maps=types.GoogleMaps())],

        # Provide the relevant location context (this is in Los Angeles)
        tool_config=types.ToolConfig(retrieval_config=types.RetrievalConfig(
            lat_lng=types.LatLng(
                latitude=34.050481, longitude=-118.248526))),
    ),
)

print("Generated Response:")
print(response.text)

if grounding := response.candidates[0].grounding_metadata:
  if chunks := grounding.grounding_chunks:
    print('-' * 40)
    print("Sources:")
    for chunk in chunks:
      print(f'- [{chunk.maps.title}]({chunk.maps.uri})')
  ```

import { GoogleGenAI } from '@google/genai';

const ai = new GoogleGenAI({});

async function run() {
  const prompt = "Is there a cafe near the corner of 1st and Main that has outdoor seating?";

  const response = await ai.models.generateContent({
    model: 'gemini-2.5-flash',
    contents: prompt,
    config: {
      // Turn on the Maps tool
      tools: [{googleMaps: {}}],
      // Provide the relevant location context (this is in Los Angeles)
      toolConfig: {
        retrievalConfig: {
          latLng: {
            latitude: 34.050481,
            longitude: -118.248526
          }
        }
      }
    },
  });

  console.log("Generated Response:");
  console.log(response.text);

  const chunks = response.candidates[0].groundingMetadata?.groundingChunks;
  if (chunks) {
    console.log('-'.repeat(40));
    console.log("Sources:");
    for (const chunk of chunks) {
      if (chunk.maps) {
        console.log(`- [${chunk.maps.title}](${chunk.maps.uri})`);
      }
    }
  }
}

run();

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent' \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: ${GEMINI_API_KEY}" \
  -d '{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "Is there a cafe near the corner of 1st and Main that has outdoor seating?"
    }]
  }],
  "tools": [{"googleMaps": {}}],
  "toolConfig": {
    "retrievalConfig": {
      "latLng": {"latitude": 34.050481, "longitude": -118.248526}
    }
  }
}'

Ofrimi i personalizimit të bazuar në vendndodhje

Merrni rekomandime të përshtatura sipas preferencave të përdoruesit dhe një zone specifike gjeografike.

from google import genai
from google.genai import types

client = genai.Client()

prompt = "Which family-friendly restaurants near here have the best playground reviews?"

response = client.models.generate_content(
    model='gemini-2.5-flash',
    contents=prompt,
    config=types.GenerateContentConfig(
      tools=[types.Tool(google_maps=types.GoogleMaps())],
      tool_config=types.ToolConfig(retrieval_config=types.RetrievalConfig(
          # Provide the location as context; this is Austin, TX.
          lat_lng=types.LatLng(
              latitude=30.2672, longitude=-97.7431))),
    ),
)

print("Generated Response:")
print(response.text)

if grounding := response.candidates[0].grounding_metadata:
  if chunks := grounding.grounding_chunks:
    print('-' * 40)
    print("Sources:")
    for chunk in chunks:
      print(f'- [{chunk.maps.title}]({chunk.maps.uri})')

import { GoogleGenAI } from '@google/genai';

const ai = new GoogleGenAI({});

async function run() {
  const prompt = "Which family-friendly restaurants near here have the best playground reviews?";

  const response = await ai.models.generateContent({
    model: 'gemini-2.5-flash',
    contents: prompt,
    config: {
      tools: [{googleMaps: {}}],
      toolConfig: {
        retrievalConfig: {
          // Provide the location as context; this is Austin, TX.
          latLng: {
            latitude: 30.2672,
            longitude: -97.7431
          }
        }
      }
    },
  });

  console.log("Generated Response:");
  console.log(response.text);

  const chunks = response.candidates[0].groundingMetadata?.groundingChunks;
  if (chunks) {
    console.log('-'.repeat(40));
    console.log("Sources:");
    for (const chunk of chunks) {
      if (chunk.maps) {
        console.log(`- [${chunk.maps.title}](${chunk.maps.uri})`);
      }
    }
  }
}

run();

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent' \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: ${GEMINI_API_KEY}" \
  -d '{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "Which family-friendly restaurants near here have the best playground reviews?"
    }],
  }],
  "tools": [{"googleMaps": {}}],
  "toolConfig": {
    "retrievalConfig": {
      "latLng": {"latitude": 30.2672, "longitude": -97.7431}
    }
  }
}'

Ndihmë me planifikimin e itinerarit

Gjeneroni plane shumëditore me udhëzime dhe informacione rreth vendeve të ndryshme, perfekte për aplikime udhëtimi.

Në këtë shembull, googleMapsWidgetContextToken është kërkuar duke aktivizuar vegël në mjetin Google Maps. Kur aktivizohet, tokeni i kthyer mund të përdoret për të paraqitur një vegël kontekstuale të Vendeve duke përdorur <gmp-places-contextual> component nga API JavaScript i Google Maps.

from google import genai
from google.genai import types

client = genai.Client()

prompt = "Plan a day in San Francisco for me. I want to see the Golden Gate Bridge, visit a museum, and have a nice dinner."

response = client.models.generate_content(
    model='gemini-2.5-flash',
    contents=prompt,
    config=types.GenerateContentConfig(
      tools=[types.Tool(google_maps=types.GoogleMaps(enable_widget=True))],
      tool_config=types.ToolConfig(retrieval_config=types.RetrievalConfig(
          # Provide the location as context, this is in San Francisco.
          lat_lng=types.LatLng(
              latitude=37.78193, longitude=-122.40476))),
    ),
)

print("Generated Response:")
print(response.text)

if grounding := response.candidates[0].grounding_metadata:
  if grounding.grounding_chunks:
    print('-' * 40)
    print("Sources:")
    for chunk in grounding.grounding_chunks:
      print(f'- [{chunk.maps.title}]({chunk.maps.uri})')

  if widget_token := grounding.google_maps_widget_context_token:
    print('-' * 40)
    print(f'<gmp-place-contextual context-token="{widget_token}"></gmp-place-contextual>')

import { GoogleGenAI } from '@google/genai';

const ai = new GoogleGenAI({});

async function run() {
  const prompt = "Plan a day in San Francisco for me. I want to see the Golden Gate Bridge, visit a museum, and have a nice dinner.";

  const response = await ai.models.generateContent({
    model: 'gemini-2.5-flash',
    contents: prompt,
    config: {
      tools: [{googleMaps: {enableWidget: true}}],
      toolConfig: {
        retrievalConfig: {
          // Provide the location as context, this is in San Francisco.
          latLng: {
            latitude: 37.78193,
            longitude: -122.40476
          }
        }
      }
    },
  });

  console.log("Generated Response:");
  console.log(response.text);

  const groundingMetadata = response.candidates[0]?.groundingMetadata;
  if (groundingMetadata) {
    if (groundingMetadata.groundingChunks) {
      console.log('-'.repeat(40));
      console.log("Sources:");
      for (const chunk of groundingMetadata.groundingChunks) {
        if (chunk.maps) {
          console.log(`- [${chunk.maps.title}](${chunk.maps.uri})`);
        }
      }
    }

    if (groundingMetadata.googleMapsWidgetContextToken) {
      console.log('-'.repeat(40));
      document.body.insertAdjacentHTML('beforeend', `<gmp-place-contextual context-token="${groundingMetadata.googleMapsWidgetContextToken}`"></gmp-place-contextual>`);
    }
  }
}

run();

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent' \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: ${GEMINI_API_KEY}" \
  -d '{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "Plan a day in San Francisco for me. I want to see the Golden Gate Bridge, visit a museum, and have a nice dinner."
    }]
  }],
  "tools": [{"googleMaps": {"enableWidget":"true"}}],
  "toolConfig": {
    "retrievalConfig": {
    "latLng": {"latitude": 37.78193, "longitude": -122.40476}
  }
  }
}'

Kur widget-i të renderohet, do të duket diçka si më poshtë:

Kërkesat e përdorimit të shërbimit

Ky seksion përshkruan kërkesat e përdorimit të shërbimit për Grounding me Google Maps.

Informoni përdoruesin rreth përdorimit të burimeve të Google Maps

Me çdo rezultat të Grounded të Google Maps, do të merrni burime në groundingChunks që mbështesin çdo përgjigje. Gjithashtu kthehen të dhënat e mëposhtme meta:

• burim uri
• titull
• ID

Kur paraqisni rezultate nga Grounding with Google Maps, duhet të specifikoni burimet e lidhura me Google Maps dhe t'i informoni përdoruesit tuaj për sa vijon:

• Burimet e Google Maps duhet të ndjekin menjëherë përmbajtjen e gjeneruar që mbështesin burimet. Kjo përmbajtje e gjeneruar njihet edhe si Rezultati i Bazuar i Google Maps.
• Burimet e Google Maps duhet të jenë të shikueshme brenda një ndërveprimi të përdoruesit.

Shfaq burimet e Google Maps me lidhjet e Google Maps

Për secilin burim në groundingChunks dhe në grounding_chunks.maps.placeAnswerSources.reviewSnippets , duhet të gjenerohet një parapamje lidhjeje duke ndjekur këto kërkesa:

• Atribuoni çdo burim te Google Maps duke ndjekur udhëzimet e atribuimit të tekstit të Google Maps.
• Shfaq titullin burimor të dhënë në përgjigje.
• Lidhu me burimin duke përdorur uri ose googleMapsUri nga përgjigjja.

Këto imazhe tregojnë kërkesat minimale për shfaqjen e burimeve dhe lidhjeve të Google Maps.

Mund ta mbyllësh pamjen e burimeve.

Opsionale: Përmirësoni pamjen paraprake të lidhjes me përmbajtje shtesë, si p.sh.:

• Një favicon i Google Maps futet përpara atribuimit të tekstit të Google Maps.
• Një foto nga URL-ja burimore ( og:image ).

Për më shumë informacion rreth disa prej ofruesve tanë të të dhënave të Google Maps dhe kushteve të tyre të licencës, shihni njoftimet ligjore të Google Maps dhe Google Earth .

Udhëzimet për atribuimin e tekstit të Google Maps

Kur ia atribuoni burimet Google Maps në tekst, ndiqni këto udhëzime:

• Mos e modifikoni tekstin në Google Maps në asnjë mënyrë:
  • Mos e ndryshoni përdorimin e shkronjave të mëdha në Google Maps.
  • Mos e mbështillni Google Maps në disa rreshta.
  • Mos e lokalizoni Google Maps në një gjuhë tjetër.
  • Parandaloni shfletuesit të përkthejnë Google Maps duke përdorur atributin HTML translate="no".
• Stiloni tekstin e Google Maps siç përshkruhet në tabelën e mëposhtme:

Shembull CSS

CSS-ja e mëposhtme e paraqet Google Maps me stilin dhe ngjyrën e duhur tipografike në një sfond të bardhë ose të çelët.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {

font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

Tokeni i kontekstit, ID-ja e vendit dhe ID-ja e rishikimit

Të dhënat e Hartave Google përfshijnë tokenin e kontekstit, ID-në e vendit dhe ID-në e rishikimit. Ju mund të ruani në memorien e përkohshme, të ruani dhe eksportoni të dhënat e mëposhtme të përgjigjes:

• googleMapsWidgetContextToken
• placeId
• reviewId

Kufizimet kundër ruajtjes në memorje të përkohshme në Kushtet e Grounding with Google Maps nuk zbatohen.

Aktiviteti dhe territori i ndaluar

Grounding with Google Maps ka kufizime shtesë për përmbajtje dhe aktivitete të caktuara për të ruajtur një platformë të sigurt dhe të besueshme. Përveç kufizimeve të përdorimit në Kushte, ju nuk do ta përdorni Grounding with Google Maps për aktivitete me rrezik të lartë, duke përfshirë shërbimet e reagimit ndaj emergjencave. Ju nuk do ta shpërndani ose tregtoni aplikacionin tuaj që ofron Grounding with Google Maps në një Territor të Ndaluar. Territoret aktuale të Ndaluara janë:

• Kinë
• Krime
• Kuba
• Republika Popullore e Donetskut
• Irani
• Republika Popullore e Luhanskut
• Koreja e Veriut
• Siri
• Vietnami

Kjo listë mund të përditësohet herë pas here.

Praktikat më të mira

• Jepni vendndodhjen e përdoruesit: Për përgjigjet më të rëndësishme dhe të personalizuara, përfshini gjithmonë user_location (gjerësinë dhe gjatësinë gjeografike) në konfigurimin tuaj googleMapsGrounding kur vendndodhja e përdoruesit është e njohur.
• Paraqitni vegël kontekstuale të Google Maps: Vegël kontekstuale paraqitet duke përdorur tokenin kontekstual, googleMapsWidgetContextToken , i cili kthehet në përgjigjen e Gemini API dhe mund të përdoret për të paraqitur përmbajtje vizuale nga Google Maps. Për më shumë informacion mbi vegël kontekstuale, shihni Bazë me vegël Google Maps në Udhëzuesin e Zhvilluesit të Google.
• Informoni Përdoruesit Fundorë: Informoni qartë përdoruesit tuaj fundorë se të dhënat e Google Maps po përdoren për t'iu përgjigjur pyetjeve të tyre, veçanërisht kur mjeti është i aktivizuar.
• Monitorimi i Latencisë: Për aplikacionet bisedore, sigurohuni që latenca P95 për përgjigjet e bazuara të mbetet brenda pragjeve të pranueshme për të ruajtur një përvojë të qetë të përdoruesit.
• Çaktivizo/Çaktivizo kur nuk nevojitet: Tokëzimi me Google Maps është çaktivizuar si parazgjedhje. Aktivizoje atë vetëm ( "tools": [{"googleMaps": {}}] ) kur një pyetje ka një kontekst të qartë gjeografik, për të optimizuar performancën dhe koston.

Kufizime

• Shtrirja Gjeografike: Aktualisht, Tokëzimi me Google Maps është i disponueshëm globalisht
• Mbështetja e Modeleve: Vetëm modele specifike të Gemini mbështesin Tokëzimin me Google Maps: Gemini 2.5 Flash-Lite, Gemini 2.5 Pro, Gemini 2.5 Flash dhe Gemini 2.0 Flash (por jo 2.0 Flash Lite).
• Hyrje/Dalje Multimodale: Tokëzimi me Google Maps aktualisht nuk mbështet hyrje ose dalje multimodale përtej veglave të hartës me tekst dhe kontekst.
• Gjendja e parazgjedhur: Mjeti "Grounding with Google Maps" është i çaktivizuar si parazgjedhje. Duhet ta aktivizoni atë në mënyrë të qartë në kërkesat tuaja API.

Çmimet dhe kufijtë e tarifave

Çmimi i grounding me Google Maps bazohet në pyetje. Tarifa aktuale është 25 dollarë / 1 mijë kërkesa të groundinguara . Një kërkesë llogaritet drejt kuotës vetëm kur një kërkesë kthen me sukses të paktën një rezultat të groundinguar të Google Maps (p.sh., rezultate që përmbajnë të paktën një burim të Google Maps). Nëse pyetje të shumta dërgohen te Google Maps nga një kërkesë e vetme, kjo llogaritet si një kërkesë drejt limitit të tarifës.

Për informacion të detajuar mbi çmimet, shihni faqen e çmimeve të Gemini API .

Modelet e mbështetura

Mund t’i gjeni aftësitë e tyre në faqen e përmbledhjes së modelit .

Çfarë vjen më pas

• Provoni Grounding me Google Search në Gemini API Cookbook .
• Mësoni rreth mjeteve të tjera të disponueshme, si thirrja e funksioneve .
• Për të mësuar më shumë rreth praktikave më të mira të përgjegjshme të IA-së dhe filtrave të sigurisë të Gemini API, shihni udhëzuesin e cilësimeve të Sigurisë .