Căn cứ vào Google Maps

Tính năng Neo bám vào Google Maps kết nối các khả năng tạo nội dung của Gemini với dữ liệu phong phú, thực tế và mới nhất của Google Maps. Tính năng này giúp nhà phát triển dễ dàng tích hợp chức năng nhận biết vị trí vào ứng dụng của họ. Khi truy vấn của người dùng có bối cảnh liên quan đến dữ liệu Maps, mô hình Gemini sẽ tận dụng Google Maps để cung cấp câu trả lời mới và chính xác về mặt thực tế, đồng thời phù hợp với vị trí cụ thể hoặc khu vực khái quát mà người dùng chỉ định.

• Câu trả lời chính xác, nhận biết vị trí: Tận dụng dữ liệu phong phú và mới nhất của Google Maps cho các truy vấn cụ thể về mặt địa lý.
• Nâng cao khả năng cá nhân hoá: Điều chỉnh đề xuất và thông tin dựa trên vị trí do người dùng cung cấp.

Bắt đầu

Ví dụ này minh hoạ cách tích hợp tính năng Neo bám vào Google Maps vào ứng dụng của bạn để cung cấp câu trả lời chính xác, nhận biết vị trí cho các truy vấn của người dùng. Lời nhắc yêu cầu các đề xuất tại địa phương kèm theo vị trí không bắt buộc của người dùng, cho phép mô hình Gemini sử dụng dữ liệu của 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-3.8-flash',
    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/genai";

const ai = new GoogleGenAI({});

async function generateContentWithMapsGrounding() {
  const response = await ai.models.generateContent({
    model: "gemini-3.8-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-3.8-flash: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}
    }
  }
}'

Cách hoạt động của tính năng Neo bám vào Google Maps

Tính năng Neo bám vào Google Maps tích hợp Gemini API với hệ sinh thái Google Geo bằng cách sử dụng Maps API làm nguồn neo bám. Khi truy vấn của người dùng chứa bối cảnh địa lý, mô hình Gemini có thể gọi công cụ Neo bám vào Google Maps. Sau đó, mô hình này có thể tạo câu trả lời dựa trên dữ liệu của Google Maps liên quan đến vị trí được cung cấp.

Quy trình này thường bao gồm:

1. Truy vấn của người dùng: Người dùng gửi một truy vấn đến ứng dụng của bạn, có thể bao gồm bối cảnh địa lý (ví dụ: "quán cà phê gần tôi", "bảo tàng ở San Francisco").
2. Gọi công cụ: Mô hình Gemini, nhận ra ý định địa lý, sẽ gọi công cụ Neo bám vào Google Maps. Bạn có thể tuỳ ý cung cấp latitude và longitude của người dùng cho công cụ này. Công cụ này là một công cụ tìm kiếm bằng văn bản và hoạt động tương tự như tìm kiếm trên Maps, trong đó các truy vấn tại địa phương ("gần tôi") sẽ sử dụng toạ độ, còn các truy vấn cụ thể hoặc không tại địa phương sẽ ít bị ảnh hưởng bởi vị trí rõ ràng.
3. Truy xuất dữ liệu: Dịch vụ Neo bám vào Google Maps truy vấn Google Maps để tìm thông tin có liên quan (ví dụ: địa điểm, bài đánh giá, ảnh, địa chỉ, giờ mở cửa).
4. Tạo nội dung dựa trên nguồn: Dữ liệu Maps được truy xuất sẽ được dùng để cung cấp thông tin cho câu trả lời của mô hình Gemini, đảm bảo tính chính xác và mức độ phù hợp về mặt thực tế.
5. Câu trả lời: Mô hình này trả về một câu trả lời bằng văn bản, bao gồm cả trích dẫn các nguồn trên Google Maps.

Lý do và thời điểm nên sử dụng tính năng Neo bám vào Google Maps

Tính năng Neo bám vào Google Maps là lựa chọn lý tưởng cho các ứng dụng yêu cầu thông tin chính xác, mới nhất và cụ thể theo vị trí. Tính năng này giúp nâng cao trải nghiệm người dùng bằng cách cung cấp nội dung phù hợp và được cá nhân hoá dựa trên cơ sở dữ liệu phong phú của Google Maps với hơn 250 triệu địa điểm trên toàn thế giới.

Bạn nên sử dụng tính năng Neo bám vào Google Maps khi ứng dụng của bạn cần:

• Cung cấp câu trả lời đầy đủ và chính xác cho các câu hỏi cụ thể về địa lý.
• Xây dựng chuyên gia lên kế hoạch chuyến đi và Local Guides dựa trên cuộc trò chuyện.
• Đề xuất các địa điểm yêu thích dựa trên vị trí và lựa chọn ưu tiên của người dùng, chẳng hạn như nhà hàng hoặc cửa hàng.
• Tạo trải nghiệm nhận biết vị trí cho các dịch vụ xã hội, bán lẻ hoặc giao đồ ăn.

Tính năng Neo bám vào Google Maps vượt trội trong các trường hợp sử dụng mà khoảng cách và dữ liệu thực tế hiện tại là rất quan trọng, chẳng hạn như tìm "quán cà phê ngon nhất gần tôi" hoặc nhận chỉ đường.

Phương thức và tham số API

Tính năng Neo bám vào Google Maps được cung cấp thông qua Gemini API dưới dạng một công cụ trong generateContent phương thức. Bạn có thể bật và định cấu hình tính năng Neo bám vào Google Maps bằng cách đưa đối tượng googleMaps vào tham số tools trong yêu cầu của mình.

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

Ngoài ra, công cụ này còn hỗ trợ việc truyền vị trí theo bối cảnh dưới dạng toolConfig.

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

Tìm hiểu về câu trả lời dựa trên nguồn

Khi một câu trả lời được neo bám thành công vào dữ liệu của Google Maps, câu trả lời đó bao gồm một groundingMetadata trường. Dữ liệu có cấu trúc này là cần thiết để xác minh các tuyên bố và xây dựng trải nghiệm trích dẫn phong phú trong ứng dụng của bạn, cũng như đáp ứng các yêu cầu về việc sử dụng dịch vụ.

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

Gemini API trả về thông tin sau đây cùng với the groundingMetadata:

• groundingChunks: Mảng các đối tượng chứa nguồn maps (uri, placeId và title).
• groundingSupports: Mảng các khối để kết nối văn bản câu trả lời của mô hình với các nguồn trong groundingChunks. Mỗi khối liên kết một khoảng văn bản (được xác định bởi startIndex và endIndex) với một hoặc nhiều groundingChunkIndices. Đây là chìa khoá để xây dựng trích dẫn nội tuyến.

Để xem đoạn mã cho biết cách hiển thị trích dẫn nội tuyến trong văn bản, hãy xem ví dụ trong tài liệu về tính năng Neo bám vào Google Tìm kiếm.

Trường hợp sử dụng

Tính năng Neo bám vào Google Maps hỗ trợ nhiều trường hợp sử dụng nhận biết vị trí. Các ví dụ sau đây minh hoạ cách các lời nhắc và tham số khác nhau có thể tận dụng tính năng Neo bám vào Google Maps. Thông tin trong Kết quả dựa trên nguồn của Google Maps có thể khác với điều kiện thực tế.

Xử lý các câu hỏi cụ thể về địa điểm

Đặt câu hỏi chi tiết về một địa điểm cụ thể để nhận câu trả lời dựa trên bài đánh giá của người dùng Google và các dữ liệu khác trên 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-3.8-flash',
    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-3.8-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-3.8-flash: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}
    }
  }
}'

Cung cấp tính năng cá nhân hoá dựa trên vị trí

Nhận các đề xuất phù hợp với lựa chọn ưu tiên của người dùng và một khu vực địa lý cụ thể.

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-3.8-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-3.8-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-3.8-flash: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}
    }
  }
}'

Hỗ trợ lập kế hoạch hành trình

Tạo kế hoạch nhiều ngày kèm theo chỉ đường và thông tin về nhiều địa điểm, phù hợp với các ứng dụng du lịch.

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-3.8-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 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})')

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-3.8-flash',
    contents: prompt,
    config: {
      tools: [{googleMaps: {}}],
      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})`);
        }
      }
    }
  }
}

run();

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash: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": {}}],
  "toolConfig": {
    "retrievalConfig": {
    "latLng": {"latitude": 37.78193, "longitude": -122.40476}
  }
  }
}'

Yêu cầu về việc sử dụng dịch vụ

Phần này mô tả các yêu cầu về việc sử dụng dịch vụ đối với tính năng Neo bám vào Google Maps.

Thông báo cho người dùng về việc sử dụng các nguồn trên Google Maps

Với mỗi kết quả dựa trên nguồn của Google Maps, bạn sẽ nhận được các nguồn trong groundingChunks hỗ trợ từng câu trả lời. Siêu dữ liệu sau đây cũng được trả về:

• uri nguồn
• tiêu đề
• ID

Khi trình bày kết quả từ tính năng Neo bám vào Google Maps, bạn phải chỉ định các nguồn liên kết trên Google Maps và thông báo cho người dùng của mình về những điều sau:

• Các nguồn trên Google Maps phải xuất hiện ngay sau nội dung được tạo mà các nguồn đó hỗ trợ. Nội dung được tạo này còn được gọi là Kết quả dựa trên nguồn của Google Maps.
• Người dùng phải xem được các nguồn trên Google Maps trong một lượt tương tác.

Hiển thị các nguồn trên Google Maps kèm theo đường liên kết đến Google Maps

Đối với mỗi nguồn trong groundingChunks và trong grounding_chunks.maps.placeAnswerSources.reviewSnippets, bạn phải tạo bản xem trước đường liên kết theo các yêu cầu sau:

• Ghi công từng nguồn cho Google Maps theo nguyên tắc ghi công văn bản của Google Maps .
• Hiển thị tiêu đề nguồn được cung cấp trong câu trả lời.
• Liên kết đến nguồn bằng cách sử dụng uri hoặc googleMapsUri trong câu trả lời.

Những hình ảnh này cho thấy các yêu cầu tối thiểu để hiển thị các nguồn và đường liên kết đến Google Maps.

Bạn có thể thu gọn chế độ xem các nguồn.

Không bắt buộc: Nâng cao bản xem trước đường liên kết bằng nội dung bổ sung, chẳng hạn như:

• Biểu tượng Google Maps được chèn trước phần ghi công văn bản của Google Maps.
• Ảnh từ URL nguồn (og:image).

Để biết thêm thông tin về một số nhà cung cấp dữ liệu của Google Maps và điều khoản cấp phép của họ, hãy xem thông báo pháp lý của Google Maps và Google Earth.

Nguyên tắc ghi công văn bản của Google Maps

Khi bạn ghi công các nguồn cho Google Maps trong văn bản, hãy tuân theo các nguyên tắc sau:

• Không sửa đổi văn bản Google Maps theo bất kỳ cách nào:
  • Không thay đổi cách viết hoa của Google Maps.
  • Không chuyển Google Maps sang nhiều dòng.
  • Không bản địa hoá Google Maps sang ngôn ngữ khác.
  • Ngăn trình duyệt dịch Google Maps bằng cách sử dụng thuộc tính HTML translate="no".
• Tạo kiểu cho văn bản Google Maps như mô tả trong bảng sau:

Ví dụ về CSS

CSS sau đây hiển thị Google Maps với kiểu và màu chữ phù hợp trên nền trắng hoặc sáng.

@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;
}

Mã địa điểm và mã bài đánh giá

Dữ liệu của Google Maps bao gồm mã địa điểm và mã bài đánh giá. Bạn có thể lưu vào bộ nhớ đệm, lưu trữ và xuất dữ liệu câu trả lời sau đây:

• placeId
• reviewId

Các hạn chế đối với việc lưu vào bộ nhớ đệm trong Điều khoản về tính năng Neo bám vào Google Maps không áp dụng.

Hoạt động và lãnh thổ bị cấm

Tính năng Neo bám vào Google Maps có thêm các hạn chế đối với một số nội dung và hoạt động để duy trì một nền tảng an toàn và đáng tin cậy. Ngoài các hạn chế về việc sử dụng trong Điều khoản:

• Bạn sẽ không sử dụng tính năng Neo bám vào Google Maps cho các hoạt động có rủi ro cao, bao gồm cả dịch vụ ứng phó khẩn cấp.
• Bạn sẽ không phân phối hoặc tiếp thị ứng dụng của mình có cung cấp tính năng Neo bám vào Google Maps ở Lãnh thổ bị cấm. Để biết thêm thông tin, hãy xem phần Lãnh thổ bị cấm của Google Maps Platform. Danh sách Lãnh thổ bị cấm có thể được cập nhật theo thời gian.

Các phương pháp hay nhất

• Cung cấp vị trí của người dùng: Để có câu trả lời phù hợp và được cá nhân hoá nhất, hãy luôn đưa user_location (vĩ độ và kinh độ) vào cấu hình googleMapsGrounding khi bạn biết vị trí của người dùng.
• Thông báo cho người dùng cuối: Thông báo rõ ràng cho người dùng cuối rằng dữ liệu của Google Maps đang được sử dụng để trả lời các truy vấn của họ, đặc biệt là khi công cụ này được bật.
• Theo dõi độ trễ: Đối với các ứng dụng trò chuyện, hãy đảm bảo rằng độ trễ P95 đối với các câu trả lời dựa trên nguồn vẫn nằm trong ngưỡng chấp nhận được để duy trì trải nghiệm người dùng mượt mà.
• Tắt khi không cần: Tính năng Neo bám vào Google Maps được tắt theo mặc định. Chỉ bật tính năng này ("tools": [{"googleMaps": {}}]) khi một truy vấn có bối cảnh địa lý rõ ràng để tối ưu hoá hiệu suất và chi phí.

Các điểm hạn chế

• Phạm vi địa lý: Tính năng Neo bám vào Google Maps được cung cấp trên toàn cầu
• Hỗ trợ mô hình: Xem phần Mô hình được hỗ trợ.
• Đầu vào/Đầu ra đa phương thức: Tính năng Neo bám vào Google Maps hiện không hỗ trợ đầu vào hoặc đầu ra đa phương thức ngoài văn bản.
• Trạng thái mặc định: Công cụ Neo bám vào Google Maps được tắt theo mặc định. Bạn phải bật công cụ này một cách rõ ràng trong các yêu cầu API.

Giá và hạn mức

Giá của tính năng Neo bám vào Google Maps sẽ khác nhau tuỳ thuộc vào thế hệ mô hình:

• Mô hình Gemini 3 và các mô hình mới hơn: Dự án của bạn sẽ bị tính phí cho mỗi cụm từ tìm kiếm mà mô hình quyết định thực thi, với 5.000 yêu cầu miễn phí mỗi tháng được chia sẻ trên tất cả các mô hình Gemini 3 và các mô hình mới hơn, sau đó là 14 USD cho mỗi 1.000 cụm từ tìm kiếm. Một lời nhắc tìm kiếm (yêu cầu API của bạn đối với mô hình) có thể khiến mô hình thực thi nhiều truy vấn tìm kiếm để tìm thông tin cần thiết. Mỗi truy vấn này được tính là một lần sử dụng công cụ có tính phí.
• Mô hình Gemini 2.5 và các mô hình cũ hơn: Dự án của bạn sẽ bị tính phí cho mỗi lời nhắc tìm kiếm (25 USD cho mỗi 1.000 lời nhắc dựa trên nguồn). Yêu cầu chỉ bị tính phí nếu lời nhắc trả về thành công ít nhất một kết quả dựa trên nguồn của Google Maps, bất kể mô hình đã thực hiện bao nhiêu truy vấn tìm kiếm riêng lẻ ở nội bộ để nhận được kết quả đó.

Hạn mức cho tính năng Neo bám vào Google Maps thường phù hợp với hạn mức của mô hình Gemini cơ bản. Để biết thông tin chi tiết về giá, hãy xem trang giá của Gemini API.

Mô hình được hỗ trợ

Các mô hình sau đây hỗ trợ tính năng Neo bám vào Google Maps:

Các tổ hợp công cụ được hỗ trợ

Bạn có thể sử dụng tính năng Neo bám vào Google Maps với các công cụ tích hợp khác như Neo bám vào Google Tìm kiếm (được hỗ trợ trên mô hình Gemini 3.5 Flash-Lite và các mô hình mới hơn) để hỗ trợ các trường hợp sử dụng phức tạp hơn. Các mô hình Gemini 3 cũng hỗ trợ việc kết hợp các công cụ tích hợp này với các công cụ tuỳ chỉnh (gọi hàm). Tìm hiểu thêm trên trang về các tổ hợp công cụ.

Bước tiếp theo

• Hãy thử tính năng Neo bám vào Google Tìm kiếm trong Gemini API Sổ tay.
• Tìm hiểu về các công cụ khác hiện có.
• Để tìm hiểu thêm về các phương pháp hay nhất về AI có trách nhiệm và bộ lọc an toàn của Gemini API, hãy xem hướng dẫn về Chế độ cài đặt an toàn.