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ë përdorë të dhënat e Google Maps.

Python 

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview",
    input="What are the best Italian restaurants within a 15-minute walk from here?",
    tools=[{
        "type": "google_maps",
        "latitude": 34.050481,
        "longitude": -118.248526
    }]
)

# Print the model's text response and annotations
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)
                if content_block.annotations:
                    print("\nSources:")
                    for annotation in content_block.annotations:
                        if annotation.type == "place_citation":
                            print(f"  - {annotation.name}: {annotation.url}")

JavaScript 

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

const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "What are the best Italian restaurants within a 15-minute walk from here?",
    tools: [{
      type: "google_maps",
      latitude: 34.050481,
      longitude: -118.248526
    }]
  });

  // Print the model's text response and annotations
  for (const step of interaction.steps) {
    if (step.type === 'model_output') {
      for (const contentBlock of step.content) {
        if (contentBlock.type === 'text') {
          console.log(contentBlock.text);
          if (contentBlock.annotations) {
            console.log("\nSources:");
            for (const annotation of contentBlock.annotations) {
              if (annotation.type === 'place_citation') {
                console.log(`  - ${annotation.name}: ${annotation.url}`);
              }
            }
          }
        }
      }
    }
  }
}

main();

PUSHTIM 

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "What are the best Italian restaurants within a 15-minute walk from here?",
    "tools": [{
      "type": "google_maps",
      "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, thërret mjetin Grounding with Google Maps. Ky mjet mund të ofrohet opsionalisht me latitude dhe longitude të përdoruesit. Mjeti është një mjet kërkimi tekstual dhe sillet në mënyrë të ngjashme me kërkimin në Harta, në atë që pyetjet lokale ("pranë meje") do të përdorin koordinatat, ndërsa pyetjet specifike ose jo-lokale nuk ka gjasa të ndikohen nga vendndodhja e qartë.
  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ërgjigje dhe shënime: Modeli kthen një përgjigje tekstuale me shënime të integruara që lidhen me burimet e Google Maps, duke u lejuar zhvilluesve të shfaqin citate dhe opsionalisht të shfaqin një vegël kontekstuale të Google Maps.

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.

Rastet e përdorimit

Tokëzimi me Google Maps mbështet një sërë rastesh përdorimi të ndërgjegjshme për vendndodhjen.

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.

Python 

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview",
    input="Is there a cafe near the corner of 1st and Main that has outdoor seating?",
    tools=[{
        "type": "google_maps",
        "latitude": 34.050481,
        "longitude": -118.248526
    }]
)

for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)
                if content_block.annotations:
                    print("\nSources:")
                    for annotation in content_block.annotations:
                        if annotation.type == "place_citation":
                            print(f"  - {annotation.name}: {annotation.url}")

JavaScript 

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

const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Is there a cafe near the corner of 1st and Main that has outdoor seating?",
    tools: [{
      type: "google_maps",
      latitude: 34.050481,
      longitude: -118.248526
    }]
  });

  for (const step of interaction.steps) {
    if (step.type === 'model_output') {
      for (const contentBlock of step.content) {
        if (contentBlock.type === 'text') {
          console.log(contentBlock.text);
          if (contentBlock.annotations) {
            console.log("\nSources:");
            for (const annotation of contentBlock.annotations) {
              if (annotation.type === 'place_citation') {
                console.log(`  - ${annotation.name}: ${annotation.url}`);
              }
            }
          }
        }
      }
    }
  }
}

main();

Ofrimi i personalizimit të bazuar në vendndodhje

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

Python 

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview",
    input="Which family-friendly restaurants near here have the best playground reviews?",
    tools=[{
        "type": "google_maps",
        "latitude": 30.2672,
        "longitude": -97.7431
    }]
)

for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)
                if content_block.annotations:
                    print("\nSources:")
                    for annotation in content_block.annotations:
                        if annotation.type == "place_citation":
                            print(f"  - {annotation.name}: {annotation.url}")

JavaScript 

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

const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Which family-friendly restaurants near here have the best playground reviews?",
    tools: [{
      type: "google_maps",
      latitude: 30.2672,
      longitude: -97.7431
    }]
  });

  for (const step of interaction.steps) {
    if (step.type === 'model_output') {
      for (const contentBlock of step.content) {
        if (contentBlock.type === 'text') {
          console.log(contentBlock.text);
          if (contentBlock.annotations) {
            console.log("\nSources:");
            for (const annotation of contentBlock.annotations) {
              if (annotation.type === 'place_citation') {
                console.log(`  - ${annotation.name}: ${annotation.url}`);
              }
            }
          }
        }
      }
    }
  }
}

main();

Ndihmë me planifikimin e itinerarit

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

Python 

from google import genai

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."

interaction = client.interactions.create(
    model="gemini-3-flash-preview",
    input=prompt,
    tools=[{
        "type": "google_maps",
        "latitude": 37.78193,
        "longitude": -122.40476,
        "enable_widget": True
    }]
)
# ... code to process response and widget token

JavaScript 

const interaction = await client.interactions.create({
    model: 'gemini-3-flash-preview',
    input: '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: [{
      type: "google_maps",
      latitude: 37.78193,
      longitude: -122.40476,
      enableWidget: true
    }],
});

PUSHTIM 

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "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": [{
      "type": "google_maps",
      "latitude": 37.78193,
      "longitude": -122.40476,
      "enable_widget": true
    }]
  }'

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ë Google Maps Grounded, do të merrni shënime burimore në blloqet e përmbajtjes së hapit model_output që mbështesin çdo përgjigje. Kthehen të dhënat meta të mëposhtme:

  • URL-ja e burimit
  • emër

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 çdo shënim burimor, duhet të gjenerohet një parapamje e lidhjes duke ndjekur këto kërkesa:

  • Atribuoni çdo burim te Google Maps duke ndjekur udhëzimet e atribuimit të tekstit të Google Maps.
  • Shfaq emrin e burimit të dhënë në përgjigje.
  • Lidhu me burimin duke përdorur url në nga shënimi.

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".

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 .

Praktikat më të mira

  • Jepni vendndodhjen e përdoruesit: Për përgjigjet më të rëndësishme dhe të personalizuara, përfshini gjithmonë latitude dhe longitude në konfigurimin e mjetit tuaj google_maps kur vendndodhja e përdoruesit është e njohur.
  • Paraqitni vegël kontekstuale të Google Maps: Vegël kontekstuale paraqitet duke përdorur tokenin kontekstual, google_maps_widget_context_token , i cili kthehet në përgjigjen e Gemini API dhe mund të përdoret për të paraqitur përmbajtje vizuale nga Google Maps.
  • 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.
  • Çaktivizo/Çaktivizo kur nuk nevojitet: Tokëzimi me Google Maps është çaktivizuar si parazgjedhje. Aktivizoje vetëm ( "tools": [{"type": "google_maps"}] ) kur një pyetje ka një kontekst të qartë gjeografik, për të optimizuar performancën dhe koston.

Kufizime

  • Tokëzimi me Google Maps aktualisht mbështet vetëm kërkesat dhe përgjigjet në gjuhën angleze.
  • Mjeti mund të mos jetë i disponueshëm në të gjitha rajonet.
  • Rezultatet mund të ndryshojnë në bazë të saktësisë së vendndodhjes dhe të dhënave të disponueshme të Hartave.
  • Shtrirja Gjeografike: Tokëzimi me Google Maps është i disponueshëm globalisht.
  • 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 . Niveli falas gjithashtu ka deri në 500 kërkesa në ditë në dispozicion. 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 (dmth., 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

Modelet e mëposhtme mbështesin Grounding me Google Maps:

Model Tokëzimi me Google Maps
Pamje paraprake e Gemini 3.1 Pro ✔️
Gemini 3.1 Flash-Lite ✔️
Pamje paraprake e Gemini 3.1 Flash-Lite ✔️
Pamje paraprake e shpejtë e Gemini 3 ✔️
Gemini 2.5 Pro ✔️
Binjakët 2.5 Flash ✔️
Gemini 2.5 Flash-Lite ✔️
Binjakët 2.0 Flash ✔️

Kombinimet e mjeteve të mbështetura

Modelet Gemini 3 mbështesin kombinimin e mjeteve të integruara (si Grounding me Google Maps) me mjete të personalizuara (thirrja e funksioneve). Mësoni më shumë në faqen e kombinimeve të mjeteve .

Çfarë vjen më pas