زمین با نقشه گوگل

اتصال به نقشه‌های گوگل، قابلیت‌های تولیدی Gemini را با داده‌های غنی، واقعی و به‌روز نقشه‌های گوگل مرتبط می‌کند. این ویژگی به توسعه‌دهندگان این امکان را می‌دهد که به راحتی قابلیت‌های آگاه از مکان را در برنامه‌های خود بگنجانند. هنگامی که یک پرس‌وجوی کاربر زمینه‌ای مرتبط با داده‌های نقشه‌ها دارد، مدل Gemini از نقشه‌های گوگل برای ارائه پاسخ‌های دقیق و به‌روز مرتبط با مکان یا منطقه عمومی مشخص شده توسط کاربر استفاده می‌کند.

  • پاسخ‌های دقیق و آگاه از موقعیت مکانی: از داده‌های گسترده و به‌روز گوگل مپ برای پرسش‌های جغرافیایی خاص استفاده کنید.
  • شخصی‌سازی پیشرفته: توصیه‌ها و اطلاعات را بر اساس مکان‌های ارائه شده توسط کاربر تنظیم کنید.

شروع کنید

این مثال نشان می‌دهد که چگونه Grounding را با Google Maps در برنامه خود ادغام کنید تا پاسخ‌های دقیق و آگاه از موقعیت مکانی به سؤالات کاربر ارائه دهید. این اعلان از شما توصیه‌های محلی با موقعیت مکانی اختیاری کاربر را درخواست می‌کند و مدل Gemini را قادر می‌سازد از داده‌های Google Maps استفاده کند.

پایتون

# This will only work for SDK newer than 2.0.0
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    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}")

جاوا اسکریپت

// This will only work for SDK newer than 2.0.0
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.8-flash",
    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();

جاوا

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.GoogleMaps;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
import java.util.Arrays;

Client client = new Client();

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(InteractionsInput.of("Find the best coffee shops near Central Park."))
        .tools(Arrays.asList(new GoogleMaps()))
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

استراحت

# Specifies the API revision to avoid breaking changes when they become default
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.8-flash",
    "input": "What are the best Italian restaurants within a 15-minute walk from here?",
    "tools": [{
      "type": "google_maps",
      "latitude": 34.050481,
      "longitude": -118.248526
    }]
  }'

نحوه اتصال به زمین با نقشه‌های گوگل

اتصال به زمین با نقشه‌های گوگل، با استفاده از API نقشه‌ها به عنوان منبع اتصال به زمین، رابط برنامه‌نویسی Gemini را با اکوسیستم Google Geo ادغام می‌کند. هنگامی که پرس‌وجوی کاربر شامل زمینه جغرافیایی باشد، مدل Gemini می‌تواند ابزار اتصال به زمین با نقشه‌های گوگل را فراخوانی کند. سپس این مدل می‌تواند پاسخ‌هایی را بر اساس داده‌های نقشه‌های گوگل مرتبط با مکان ارائه شده تولید کند.

این فرآیند معمولاً شامل موارد زیر است:

  1. پرس‌وجوی کاربر: کاربر پرس‌وجویی را به برنامه شما ارسال می‌کند که احتمالاً شامل زمینه جغرافیایی نیز می‌شود (مثلاً «کافی شاپ‌های نزدیک من»، «موزه‌های سانفرانسیسکو»).
  2. فراخوانی ابزار: مدل Gemini، با تشخیص هدف جغرافیایی، ابزار Grounding with Google Maps را فراخوانی می‌کند. این ابزار می‌تواند به صورت اختیاری latitude و longitude جغرافیایی کاربر را در اختیار قرار دهد. این ابزار یک ابزار جستجوی متنی است و مشابه جستجو در Maps رفتار می‌کند، به این صورت که جستجوهای محلی ("نزدیک من") از مختصات استفاده می‌کنند، در حالی که جستجوهای خاص یا غیر محلی بعید است که تحت تأثیر مکان صریح قرار گیرند.
  3. بازیابی داده‌ها: سرویس Grounding with Google Maps اطلاعات مرتبط (مثلاً مکان‌ها، نظرات، عکس‌ها، آدرس‌ها، ساعات کاری) را از Google Maps جستجو می‌کند.
  4. تولید مبتنی بر داده: داده‌های بازیابی‌شده‌ی Maps برای اطلاع‌رسانی به پاسخ مدل Gemini استفاده می‌شوند و دقت و ارتباط واقعی را تضمین می‌کنند.
  5. پاسخ و حاشیه‌نویسی‌ها: این مدل یک پاسخ متنی با حاشیه‌نویسی‌های درون‌خطی که به منابع نقشه‌های گوگل لینک می‌دهند، برمی‌گرداند و به توسعه‌دهندگان اجازه می‌دهد تا استنادها را نمایش دهند.

چرا و چه زمانی از اتصال به زمین با نقشه‌های گوگل استفاده کنیم؟

اتصال به زمین با نقشه‌های گوگل برای برنامه‌هایی که نیاز به اطلاعات دقیق، به‌روز و مختص به مکان دارند، ایده‌آل است. این سرویس با ارائه محتوای مرتبط و شخصی‌سازی‌شده که توسط پایگاه داده گسترده نقشه‌های گوگل با بیش از ۲۵۰ میلیون مکان در سراسر جهان پشتیبانی می‌شود، تجربه کاربری را بهبود می‌بخشد.

شما باید زمانی از اتصال به زمین با نقشه‌های گوگل استفاده کنید که برنامه شما نیاز به موارد زیر داشته باشد:

  • به سوالات مربوط به جغرافیا پاسخ‌های کامل و دقیقی ارائه دهید.
  • برنامه‌ریزان سفر و راهنمایان محلیِ اهل مکالمه بسازید.
  • نقاط مورد علاقه را بر اساس موقعیت مکانی و ترجیحات کاربر مانند رستوران‌ها یا مغازه‌ها پیشنهاد دهید.
  • برای خدمات اجتماعی، خرده‌فروشی یا تحویل غذا، تجربیات مبتنی بر موقعیت مکانی ایجاد کنید.

اتصال زمینی با نقشه‌های گوگل در مواردی که نزدیکی و داده‌های واقعی فعلی حیاتی هستند، مانند یافتن «بهترین کافی‌شاپ نزدیک من» یا دریافت مسیر، بسیار عالی عمل می‌کند.

موارد استفاده

اتصال به زمین با نقشه‌های گوگل از موارد استفاده متنوعی با توجه به موقعیت مکانی پشتیبانی می‌کند.

رسیدگی به سوالات مربوط به مکان

سوالات دقیقی در مورد یک مکان خاص بپرسید تا بر اساس نظرات کاربران گوگل و سایر داده‌های نقشه، پاسخ دریافت کنید.

پایتون

# This will only work for SDK newer than 2.0.0
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    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: