Часто задаваемые вопросы о геокодировании
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
В этом FAQ рассматриваются вопросы, специфичные для API геокодирования. Обратитесь к FAQ по платформе Google Maps для вопросов, общих для всех платформ Google Maps. См. также Best Practices When Geocoding Addresses .
Поиск неисправностей
Поиск неисправностей
- Я получаю больше запросов, которые возвращают ZERO_RESULTS с геокодером. Что происходит?
В геокодере неоднозначные, неполные и плохо отформатированные запросы, такие как неправильно написанные или несуществующие адреса, склонны выдавать ZERO_RESULTS. Если адрес не может быть найден, ZERO_RESULTS предпочтительнее частичного результата (например, возвращая только пригород вместо адреса).
Если ваше приложение имеет дело с вводом адресов пользователем, функция автозаполнения Place в API Places может выдавать более качественные результаты. Автозаполнение Place позволяет пользователям выбирать из набора результатов на основе того, что они ввели, что позволяет пользователям выбирать между результатами с похожими именами и корректировать свой запрос, если они неправильно написали адрес.
Если у вас есть приложение, работающее с неоднозначными или неполными запросами или запросами, которые могут содержать ошибки, мы рекомендуем вам использовать функцию автозаполнения мест в API мест, а не прямой геокодер, доступный в API геокодирования. Для получения более подробной информации см. Best Practices When Geocoding Addresses и Address Geocoding в записи блога API Google Maps .
- Мне нужны быстрые ответы, а геокодер слишком медленный для моего приложения. Что я могу использовать для более быстрых ответов?
Мы рекомендуем, чтобы приложения, которые реагируют на пользовательский ввод и, следовательно, очень чувствительны к задержке, использовали функцию Place Autocomplete в API Places (также доступна в JavaScript , Android или iOS ) вместо того, чтобы обращаться к геокодированию. Place Autocomplete оптимизирован для интерактивного использования и, таким образом, имеет очень низкую задержку.
Геокодирование адресов в Geocoding API оптимизировано для использования с полными, недвусмысленными, хорошо отформатированными адресами, такими как адреса доставки, введенные в онлайн-формы, и, таким образом, имеет более высокую задержку, чем Place Autocomplete. Прямой геокодер имеет большее покрытие и лучшее качество результата, но с несколько более высокой задержкой.
- Как можно уменьшить задержку в Directions API (устаревшей версии) и Distance Matrix API (устаревшей версии)?
Вместо адресов используйте идентификаторы мест для указания точек маршрута, отправной точки и пункта назначения. Идентификаторы мест лучше всего получать из функции автозаполнения мест в API мест или библиотеки мест в API JavaScript Карт. См. также информацию о параметре placeIdOnly , который можно использовать для снижения стоимости автозаполнения мест.
Когда Directions API (устаревшая версия) или Distance Matrix API (устаревшая версия) запрашивается со строкой адреса, а не с идентификатором места или latlng, они используют тот же бэкэнд, что и Geocoding API, для преобразования этого адреса в идентификатор места перед расчетом маршрута. Place Autocomplete быстрее, чем геокодирование адреса. Для приложений, которые используют Directions API (устаревшая версия) или Distance Matrix API (устаревшая версия) в ситуациях, чувствительных к задержкам, например, при реагировании на ввод данных пользователем, мы рекомендуем использовать Place Autocomplete для получения идентификаторов мест, соответствующих этим адресам, и передавать идентификаторы мест в Directions API (устаревшая версия) или Distance Matrix API (устаревшая версия). Такой подход значительно сокращает задержку. См. нашу документацию для примера того, как использовать Place Autocomplete с маршрутами .
- Как сообщить об ошибках в геокодере?
Если у вас есть сообщения об ошибках или пожелания по функциям для службы прямого геокодирования, сообщите нам об этом, используя нашу публичную систему отслеживания ошибок .
- Геокодер не выдает хороших результатов для моего варианта использования. Какая помощь доступна?
Сообщите нам об этом, используя наш общедоступный трекер проблем , поделившись несколькими конкретными вопросами, чтобы мы могли провести расследование и выяснить, есть ли какие-либо ошибки или системные проблемы, вызывающие проблемы с качеством результатов, или есть ли какие-либо изменения, которые мы можем внести в руководство по передовым практикам , чтобы помочь разработчикам добиться лучших результатов.
- Как добиться наилучших результатов с помощью геокодера, используя фильтрацию компонентов?
В геокодере фильтрация компонентов применяет только ограничения postal_code и country . Следующие примеры иллюстрируют, как лучше всего использовать фильтрацию компонентов в зависимости от необходимых вам результатов. В URL-адресах образцов запросов обязательно замените `YOUR_API_KEY` на ваш фактический ключ API.
- Чтобы ограничить почтовые индексы определенной страной, обязательно укажите ограничение страны, используя код страны ISO 3166-2 . Например:
components=country:CH|postal_code:8000 возвращает "8000 Zürich, Switzerland". https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
- Чтобы ограничить запросы определенной страной, обязательно укажите ограничение по стране, используя код страны ISO 3166-2 . Названия стран и другие сокращения могут не давать тех же результатов, что и коды стран.
Примеры:
- Геокодирование для
components=country:FRA|locality:gallus возвращает сублокальность Галлус во Франкфурте-на-Майне, Германия. Это связано с тем, что трехбуквенный код страны для Франции (FRA) не поддерживается, поэтому результаты в любой стране допускаются, а результат во Франкфурте подходит лучше, чем что-либо во Франции. https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
- Geocoding API не обязательно вернет несколько результатов для неоднозначных запросов. На такие запросы лучше отвечает Place Autocomplete.
Примеры:
- Геокодирование для
components=country:US|locality:madrid возвращает «Madrid, NM 87010, USA», но ни один из других городов США с названием «Madrid». https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
- Использование автозаполнения мест для
input=madrid&components=country:us&types=(regions) , а также указание области просмотра с использованием location и radius для смещения результатов местоположения , генерирует ответ с несколькими городами в США с названием «Madrid». https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\u003cp\u003eThis FAQ addresses questions about the Geocoding API; for general Google Maps Platform questions, refer to the Google Maps Platform FAQ.\u003c/p\u003e\n"],["\u003cp\u003eFor applications with user input and latency sensitivity, Google recommends using Place Autocomplete instead of address geocoding for better results and speed.\u003c/p\u003e\n"],["\u003cp\u003eTo improve latency with the Directions or Distance Matrix APIs, use place IDs obtained from Place Autocomplete instead of addresses.\u003c/p\u003e\n"],["\u003cp\u003eYou can report bugs or request features for the Geocoding API through the public issue tracker.\u003c/p\u003e\n"],["\u003cp\u003eComponent filtering in the Geocoding API is primarily used to restrict results by country and postal code.\u003c/p\u003e\n"]]],[],null,["This FAQ covers questions specific to the Geocoding API.\nRefer to the [Google Maps Platform FAQ](/maps/faq) for questions\ncommon to all Google Maps Platform. See also\n[Best Practices When Geocoding Addresses](/maps/documentation/geocoding/best-practices).\n\nTroubleshooting\n\n- [I'm getting more queries that return ZERO_RESULTS with the geocoder. What's going on?](#trbl-zero-results)\n- [I need fast responses, and the geocoder is too slow for my application. What can\n I use for faster responses?](#trbl-slow)\n- [How can I mitigate the latency on the Directions API (Legacy) and\n Distance Matrix API (Legacy)?](#trbl-latency)\n- [How do I report bugs in the geocoder?](#trbl-report-bug)\n- [The geocoder isn't producing good results for my use case. What help is available?](#trbl-help)\n- [How do I get the best results with the geocoder using component filtering?](#trbl-component-filtering)\n\nTroubleshooting\n\n\nI'm getting more queries that return ZERO_RESULTS with the geocoder. What's going on?\n\n: In the geocoder, ambiguous, incomplete and badly formatted queries, such as\n misspelled or nonexistent addresses, are prone to produce ZERO_RESULTS.\n If the address cannot be found, ZERO_RESULTS is preferable to a partial\n result (for example returning only the suburb in lieu of an address).\n\n If your application deals with user input of addresses, the\n [Place Autocomplete](/maps/documentation/places/web-service/autocomplete) feature\n in the Places API may produce better quality results.\n Place Autocomplete allows users to select from a set of results based on what\n they've typed, which allows users to choose between similarly named results,\n and to adjust their query if they misspell an address.\n\n If you have an application dealing with ambiguous or incomplete queries or queries\n that may contain errors, we recommend you use the\n [Place Autocomplete](/maps/documentation/places/web-service/autocomplete) feature\n in the Places API rather than the forward geocoder\n available in the Geocoding API. For more details, see\n [Best Practices When Geocoding Addresses](/maps/documentation/geocoding/best-practices) and the\n [Address Geocoding in the Google Maps APIs blog post](https://mapsplatform.google.com/resources/blog/address-geocoding-in-google-maps-apis/).\n\n\nI need fast responses, and the geocoder is too slow for my application. What can\nI use for faster responses?\n\n: We recommend that applications that respond to user input, and therefore are highly\n latency-sensitive, use the [Place Autocomplete](/maps/documentation/places/web-service/autocomplete)\n feature in the Places API (also available in\n [JavaScript](/maps/documentation/javascript/places-autocomplete),\n [Android](/maps/documentation/places/android-sdk/autocomplete), or\n [iOS](/maps/documentation/places/ios-sdk/autocomplete)) rather than address geocoding.\n Place Autocomplete is optimized to be used interactively, and thus has very low latency.\n\n Address geocoding in the Geocoding API is optimized for use with\n complete, unambiguous, well formatted addresses, such as delivery addresses entered into\n online forms, and thus has higher latency than Place Autocomplete. The forward geocoder\n has greater coverage and better result quality, but with somewhat higher latency.\n\n\nHow can I mitigate the latency on the Directions API (Legacy) and\nDistance Matrix API (Legacy)?\n\n: Instead of addresses, use [place IDs](/maps/documentation/places/web-service/place-id) to\n specify waypoints, origin, and destination. Place IDs are best obtained from the\n [Place Autocomplete](/maps/documentation/places/web-service/autocomplete)\n feature in the Places API or the\n [Places library](/maps/documentation/javascript/places-autocomplete) in the\n Maps JavaScript API. See also the information on the\n [`placeIdOnly`](/maps/documentation/javascript/places-autocomplete#placeidonly) option, which can be used to reduce the cost of\n Place Autocomplete.\n\n When the Directions API (Legacy) or Distance Matrix API (Legacy)\n is queried with an address string rather than a place ID or latlng, they use the same\n backend as the Geocoding API to convert that address into a\n place ID prior to calculating directions. Place Autocomplete is faster than address\n geocoding. For applications that use the Directions API (Legacy) or\n Distance Matrix API (Legacy) in highly latency-sensitive situations, such as\n responding to user input, we recommended you use Place Autocomplete to get the place IDs\n corresponding to those addresses, and pass the place IDs to the\n Directions API (Legacy) or Distance Matrix API (Legacy).\n This approach reduces latency significantly. See our documentation for an\n [example of how to use Place Autocomplete with directions](/maps/documentation/javascript/examples/places-autocomplete-directions).\n\n\nHow do I report bugs in the geocoder?\n\n: If you have any\n [bug reports](https://issuetracker.google.com/savedsearches/558483) or\n [feature requests](https://issuetracker.google.com/issues/new?component=188871&template=788905) for the forward geocoder service, let us know using our public\n [issue tracker](https://issuetracker.google.com/issues/new?component=188871&template=788906).\n\n\nThe geocoder isn't producing good results for my use case. What help is available?\n\n: Let us know using our public\n [issue tracker](https://issuetracker.google.com/savedsearches/558483), sharing a few specific queries, so we can investigate to\n see if there are any bugs or systemic issues causing problems with result\n quality, or if there are any changes we can make to the\n [best practices guide](/maps/documentation/geocoding/best-practices)\n to help developers get better results.\n\n\nHow do I get the best results with the geocoder using component filtering?\n\n: In the geocoder, [component filtering](/maps/documentation/geocoding/overview#component-filtering) enforces only `postal_code` and\n `country` restrictions. The following examples illustrate how best to use component\n filtering, depending on the results you need. In the sample request URLs, be sure to\n replace \\`YOUR_API_KEY\\` with your actual API key.\n\n - To restrict postal codes to a specific country, be sure to specify the country restriction using an [ISO 3166-2 country code](https://en.wikipedia.org/wiki/ISO_3166-2). For example: `components=country:CH|postal_code:8000` returns \"8000 Zürich, Switzerland\". \n\n ```scdoc\n https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY\n ```\n - To restrict queries to a specific country, be sure to specify the country restriction using an [ISO 3166-2 country code](https://en.wikipedia.org/wiki/ISO_3166-2). Country names and other abbreviations may not produce the same results as country codes.\n\n Examples:\n - Geocoding for `components=country:FRA|locality:gallus` returns the sublocality of Gallus in Frankfurt am Main, Germany. This is because the 3-letter country code for France (FRA) isn't supported, thus results in any country are allowed and the result in Frankfurt is a better fit than anything in France. \n\n ```scdoc\n https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY\n ```\n - Geocoding API won't necessarily return multiple results for ambiguous queries. Such queries are better answered by the Place Autocomplete. Examples:\n\n - Geocoding for `components=country:US|locality:madrid` returns \"Madrid, NM 87010, USA\" but none of the other cities in the USA named \"Madrid\". \n\n ```scdoc\n https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY\n ```\n - Using Place Autocomplete for `input=madrid&components=country:us&types=(regions)`, and also specifying a viewport using `location` and `radius` to [bias the location results](/maps/documentation/places/web-service/autocomplete#location_biasing), generates a response with several cities in the USA named \"Madrid\". \n\n ```carbon\n https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY\n ```"]]
