Заземление с помощью Google Maps

Функция «Привязка к местоположению с помощью Google Maps» объединяет генеративные возможности Gemini с богатыми, фактическими и актуальными данными Google Maps. Эта функция позволяет разработчикам легко интегрировать в свои приложения функциональность, учитывающую местоположение. Когда пользовательский запрос имеет контекст, связанный с данными Maps, модель Gemini использует Google Maps для предоставления фактически точных и актуальных ответов, которые соответствуют указанному местоположению или району пользователя.

  • Точные ответы с учетом местоположения: используйте обширные и актуальные данные Google Maps для выполнения запросов, привязанных к конкретному географическому местоположению.
  • Расширенные возможности персонализации: адаптация рекомендаций и информации на основе предоставленных пользователем данных о местоположении.
  • Контекстная информация и виджеты: контекстные токены для отображения интерактивных виджетов Google Maps рядом с сгенерированным контентом.

Начать

В этом примере показано, как интегрировать Grounding с Google Maps в ваше приложение для предоставления точных ответов на запросы пользователей с учетом их местоположения. Запрос содержит локальные рекомендации с возможностью указания местоположения пользователя, что позволяет модели Gemini использовать данные Google Maps.

Python

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-flash-preview',
    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})')

JavaScript

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

const ai = new GoogleGenAI({});

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

Как работает функция определения местоположения с помощью Google Maps

Функция «Привязка к Google Maps» интегрирует API Gemini с экосистемой Google Geo, используя API Google Maps в качестве источника данных. Когда запрос пользователя содержит географический контекст, модель Gemini может вызвать инструмент «Привязка к Google Maps». Затем модель может сгенерировать ответы, основанные на данных Google Maps, относящихся к указанному местоположению.

Этот процесс обычно включает в себя:

  1. Пользовательский запрос: Пользователь отправляет запрос в ваше приложение, потенциально включающий географический контекст (например, «кофейни рядом со мной», «музеи в Сан-Франциско»).
  2. Вызов инструмента: Модель Gemini, распознавая географическое местоположение, вызывает инструмент «Привязка к Google Maps». Для этого инструмента можно дополнительно указать latitude и longitude пользователя. Инструмент представляет собой текстовый поиск и работает аналогично поиску на Картах: локальные запросы («рядом со мной») будут использовать координаты, в то время как конкретные или нелокальные запросы вряд ли будут зависеть от указанного местоположения.
  3. Получение данных: Сервис Grounding with Google Maps запрашивает у Google Maps соответствующую информацию (например, места, отзывы, фотографии, адреса, часы работы).
  4. Создание обоснованных моделей: полученные данные карт используются для формирования ответа модели Gemini, обеспечивая фактическую точность и релевантность.
  5. Токен ответа и виджета: Модель возвращает текстовый ответ, содержащий ссылки на источники Google Maps. Опционально, ответ API может также содержать google_maps_widget_context_token , позволяющий разработчикам отображать контекстный виджет Google Maps в своем приложении для визуального взаимодействия.

Почему и когда использовать функцию Grounding в Google Maps

Функция Grounding with Google Maps идеально подходит для приложений, требующих точной, актуальной и привязанной к местоположению информации. Она улучшает пользовательский опыт, предоставляя релевантный и персонализированный контент, основанный на обширной базе данных Google Maps, содержащей более 250 миллионов мест по всему миру.

Использовать функцию Grounding с Google Maps следует, когда вашему приложению необходимо:

  • Предоставляйте полные и точные ответы на вопросы, касающиеся конкретных географических регионов.
  • Создавайте интерактивные планировщики поездок и местных гидов.
  • Рекомендуйте достопримечательности на основе местоположения и предпочтений пользователя, например, рестораны или магазины.
  • Создавайте приложения с учетом местоположения для социальных сетей, розничной торговли или служб доставки еды.

Функция навигации с помощью Google Maps превосходно подходит для случаев, когда важны близость местоположения и актуальные фактические данные, например, для поиска «лучшей кофейни рядом со мной» или получения маршрута.

Методы и параметры API

Функция "Приземление с помощью Google Maps" доступна через API Gemini в качестве инструмента в методе generateContent . Для включения и настройки функции "Приземление с помощью Google Maps" необходимо указать объект googleMaps в параметре tools вашего запроса.

JSON

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

Инструмент googleMaps дополнительно может принимать логический параметр enableWidget , который используется для управления тем, возвращается ли в ответе поле googleMapsWidgetContextToken . Это можно использовать для отображения контекстного виджета «Места» .

JSON

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

Кроме того, инструмент поддерживает передачу контекстного местоположения в качестве toolConfig .

JSON

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

Понимание реакции заземления

Когда ответ успешно сопоставлен с данными Google Maps, он включает поле groundingMetadata . Эти структурированные данные необходимы для проверки утверждений и создания удобного интерфейса цитирования в вашем приложении, а также для выполнения требований к использованию сервиса.

JSON

{
  "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 Gemini возвращает следующую информацию вместе с параметром groundingMetadata :

  • groundingChunks : Массив объектов, содержащих источники maps ( uri , placeId и title ).
  • groundingSupports : Массив фрагментов для связи текста ответа модели с источниками в groundingChunks . Каждый фрагмент связывает фрагмент текста (определяемый параметрами startIndex и endIndex ) с одним или несколькими groundingChunkIndices . Это ключ к созданию встроенных цитат.
  • googleMapsWidgetContextToken : текстовый токен, который можно использовать для отображения контекстного виджета «Места» .

Пример кода, демонстрирующий отображение встроенных цитат в тексте, можно найти в документации Grounding with Google Search.

Отобразить контекстный виджет Google Maps

Для использования возвращаемого значения googleMapsWidgetContextToken необходимо загрузить JavaScript API Google Maps .

Варианты использования

Функция определения местоположения с помощью Google Maps поддерживает множество сценариев использования, учитывающих местоположение. Следующие примеры демонстрируют, как различные запросы и параметры могут использовать функцию определения местоположения с помощью Google Maps. Информация в результатах определения местоположения в Google Maps может отличаться от фактических условий.

Обработка вопросов, специфичных для конкретного места.

Задавайте подробные вопросы о конкретном месте, чтобы получить ответы, основанные на отзывах пользователей Google и других данных Картов.

Python

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-flash-preview',
    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})')
  ```

JavaScript

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

Предоставление персонализации на основе местоположения.

Получайте рекомендации, адаптированные к предпочтениям пользователя и конкретному географическому региону.

Python

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-flash-preview',
    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})')

JavaScript

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

Помощь в планировании маршрута.

Создавайте многодневные планы с указаниями маршрута и информацией о различных местах, идеально подходящие для путешествий.

В этом примере токен googleMapsWidgetContextToken запрашивается путем включения виджета в инструменте Google Maps. После включения возвращенный токен можно использовать для отображения контекстного виджета «Места» с помощью <gmp-places-contextual> component из JavaScript API Google Maps.

Python

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-flash-preview',
    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>')

JavaScript

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-flash-preview',
    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-3-flash-preview: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}
  }
  }
}'

После отрисовки виджет будет выглядеть примерно так:

Пример отображения виджета карт.

Требования к использованию сервиса

В этом разделе описаны требования к использованию сервиса Grounding with Google Maps.

Проинформируйте пользователя об использовании ресурсов Google Maps.

Для каждого результата поиска в Google Maps Grounded вы получите источники в groundingChunks , подтверждающие каждый ответ. Также возвращаются следующие метаданные:

  • источник uri
  • заголовок
  • ИДЕНТИФИКАТОР

При отображении результатов поиска с помощью функции Grounding with Google Maps необходимо указать соответствующие источники Google Maps и проинформировать пользователей о следующем:

  • Исходные данные Google Maps должны непосредственно следовать за сгенерированным контентом, который эти источники поддерживают. Этот сгенерированный контент также называется результатом, соответствующим данным Google Maps.
  • Исходные данные Google Maps должны быть доступны для просмотра в рамках одного взаимодействия пользователя.

Отображение источников Google Maps со ссылками на Google Maps

Для каждого источника в groundingChunks и в grounding_chunks.maps.placeAnswerSources.reviewSnippets необходимо сгенерировать предварительный просмотр ссылки в соответствии со следующими требованиями:

На этих изображениях показаны минимальные требования к отображению источников и ссылок на Google Maps.

Запрос с указанием источников ответа.

Вы можете свернуть отображение источников.

Оперативный ответ, но источники информации оказались недоступны.

Дополнительно: Улучшите предварительный просмотр ссылки, добавив дополнительный контент, например:

  • Перед текстом, содержащим ссылку на Google Maps, вставляется значок Google Maps (favicon) .
  • Фотография взята из исходного URL ( og:image ).

Для получения дополнительной информации о некоторых поставщиках данных Google Maps и условиях их лицензирования, ознакомьтесь с юридическими уведомлениями Google Maps и Google Earth .

Рекомендации Google Maps по указанию авторства текста

При указании источников Google Maps в тексте следуйте этим рекомендациям:

  • Не изменяйте текст Google Maps никаким образом:
    • Не меняйте регистр букв в названии Google Maps.
    • Не переносите Google Maps на несколько строк.
    • Не следует локализовать Google Maps на другой язык.
    • Предотвратите перевод Google Maps браузерами, используя HTML-атрибут translate="no".
  • Оформите текст в Google Maps в соответствии с описанием в следующей таблице:
Свойство Стиль
Font family Roboto. Загрузка шрифта необязательна.
Fallback font family Любой шрифт без засечек, уже используемый в вашем продукте, или "Sans-Serif" для вызова системного шрифта по умолчанию.
Font style Нормальный
Font weight 400
Font color Белый, черный (#1F1F1F) или серый (#5E5E5E). Сохраняйте доступный контраст (4,5:1) с фоном.
Font size
  • Минимальный размер шрифта: 12sp
  • Максимальный размер шрифта: 16sp
  • Чтобы узнать больше о sp, см. раздел «Единицы измерения размера шрифта» на веб-сайте Material Design .
Spacing Нормальный

Пример CSS

Приведенный ниже CSS-код отображает Google Maps с соответствующим типографическим стилем и цветом на белом или светлом фоне.

CSS

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

Контекстный токен, идентификатор места и идентификатор отзыва.

Данные Google Maps включают контекстный токен, идентификатор места и идентификатор отзыва. Вы можете кэшировать, сохранять и экспортировать следующие данные ответа:

  • googleMapsWidgetContextToken
  • placeId
  • reviewId

Ограничения на кэширование, указанные в Условиях использования Grounding with Google Maps, здесь не применяются.

Запрещенная деятельность и территория

Использование Google Maps на практике накладывает дополнительные ограничения на определенный контент и действия для обеспечения безопасности и надежности платформы. Помимо ограничений использования, указанных в Условиях :

  • Функция Grounding в Google Maps не предназначена для мероприятий с высоким риском, включая вызовы экстренных служб.
  • Вам запрещается распространять или продавать свое приложение, предлагающее функцию "Приземление с помощью Google Maps", на запрещенной территории. В настоящее время запрещенными территориями являются:

    • Китай
    • Крым
    • Куба
    • Донецкая Народная Республика
    • Иран
    • Луганская Народная Республика
    • Северная Корея
    • Сирия
    • Вьетнам

    Этот список может периодически обновляться.

Передовые методы

  • Укажите местоположение пользователя: для получения наиболее релевантных и персонализированных ответов всегда указывайте user_location (широту и долготу) в конфигурации googleMapsGrounding , если местоположение пользователя известно.
  • Отображение контекстного виджета Google Maps: Контекстный виджет отображается с использованием контекстного токена googleMapsWidgetContextToken , который возвращается в ответе API Gemini и может использоваться для отображения визуального контента из Google Maps. Для получения дополнительной информации о контекстном виджете см. раздел «Привязка к виджету Google Maps» в Руководстве разработчика Google.
  • Проинформируйте конечных пользователей: Четко объясните конечным пользователям, что данные Google Maps используются для ответа на их запросы, особенно когда этот инструмент включен.
  • Мониторинг задержки: Для приложений, работающих в режиме диалога, убедитесь, что задержка P95 для обоснованных ответов остается в допустимых пределах для обеспечения бесперебойной работы пользователя.
  • Отключайте, когда не требуется: функция определения географического контекста с помощью Google Maps по умолчанию отключена. Включайте её ( "tools": [{"googleMaps": {}}] ) только тогда, когда запрос имеет чёткий географический контекст, чтобы оптимизировать производительность и снизить затраты.

Ограничения

  • Географический охват: функция Grounding with Google Maps доступна по всему миру.
  • Поддержка моделей: см. раздел «Поддерживаемые модели» .
  • Мультимодальные входные/выходные данные: В настоящее время Grounding with Google Maps не поддерживает мультимодальные входные или выходные данные, помимо текстовых и контекстных виджетов карты.
  • Состояние по умолчанию: Инструмент «Приземление с помощью Google Maps» по умолчанию отключен. Вам необходимо явно включить его в своих запросах к API.

Ограничения по ценам и тарифам

Стоимость услуг Google Maps по обработке запросов зависит от количества запросов. Текущая ставка составляет 25 долларов США за 1000 обработанных запросов . Бесплатный тариф также позволяет обрабатывать до 500 запросов в день. Запрос засчитывается в квоту только в том случае, если запрос успешно возвращает хотя бы один обработанный результат Google Maps (т.е. результаты, содержащие хотя бы один источник Google Maps). Если в Google Maps отправляется несколько запросов из одного запроса, это засчитывается как один запрос в лимит.

Подробную информацию о ценах см. на странице цен Gemini API .

Поддерживаемые модели

Следующие модели поддерживают функцию "Земля с Google Maps":

Модель Определить местоположение с помощью Google Maps
Gemini 3.1 Pro Preview ✔️
Предварительная версия Gemini 3.1 Flash-Lite ✔️
Предварительный просмотр Gemini 3 Flash ✔️
Gemini 2.5 Pro ✔️
Вспышка Gemini 2.5 ✔️
Фонарь Gemini 2.5 Flash-Lite ✔️
Gemini 2.0 Flash ✔️

Поддерживаемые комбинации инструментов

В моделях Gemini 3 поддерживается комбинирование встроенных инструментов (например, определение местоположения с помощью Google Maps) с пользовательскими инструментами (вызов функций). Подробнее см. на странице с описанием комбинаций инструментов .

Что дальше?