Preguntas frecuentes sobre la codificación geográfica
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En estas Preguntas frecuentes, se abordan cuestiones específicas de la API de Geocoding.
Consulta las Preguntas frecuentes sobre Google Maps Platform para conocer las cuestiones comunes acerca de dicho producto. Consulta también Prácticas recomendadas para geocodificar direcciones.
Solución de problemas
Solución de problemas
-
Recibo más consultas que muestran ZERO_RESULTS con el geocodificador. ¿Qué sucede?
-
En el geocodificador, las consultas ambiguas, incompletas y con formato incorrecto, como direcciones con errores ortográficos o inexistentes, suelen generar ZERO_RESULTS.
Si no se puede encontrar la dirección, es preferible ZERO_RESULTS a un resultado parcial (por ejemplo, mostrar solo el suburbio en lugar de una dirección).
Si tu aplicación se ocupa de las entradas de direcciones de los usuarios, la función Place Autocomplete de la API de Places puede producir resultados de mejor calidad.
Place Autocomplete permite a los usuarios seleccionar entre un conjunto de resultados según lo que escribieron, lo que les permite elegir entre resultados con nombres similares y ajustar su consulta si escriben mal una dirección.
Si tienes una aplicación que se ocupa de consultas ambiguas o incompletas, o que pueden contener errores, te recomendamos que uses la función Place Autocomplete en la API de Places en lugar del geocodificador directo disponible en la API de Geocoding. Para obtener más información, consulta
Prácticas recomendadas para geocodificar direcciones y
Geocodificación de direcciones en la entrada de blog de las APIs de Google Maps.
-
Necesito respuestas rápidas, y el geocodificador es demasiado lento para mi aplicación. ¿Qué puedo usar para obtener respuestas más rápidas?
-
Recomendamos que las aplicaciones que respondan a las entradas del usuario y, por lo tanto, sean muy sensibles a la latencia, usen la función Place Autocomplete de la API de Places (también disponible en JavaScript, Android o iOS) en lugar de la geocodificación de direcciones.
Esta función está optimizada para usarse de manera interactiva; por lo tanto, su latencia es muy reducida.
La geocodificación de direcciones en la API de Geocoding está optimizada para usarse con direcciones completas, sin ambigüedades y con un formato correcto, como las direcciones de entrega ingresadas en formularios en línea, por lo que tiene una latencia más alta que Place Autocomplete. El geocodificador directo tiene una mayor cobertura y una mejor calidad de los resultados, pero con una latencia un poco más alta.
-
¿Cómo puedo mitigar la latencia en la API de Directions (heredada) y en la API de Distance Matrix (heredada)?
-
En lugar de direcciones, usa IDs de lugares para especificar puntos de referencia, origen y destino. Los IDs de lugar se obtienen mejor de la función Place Autocomplete en la API de Places o de la biblioteca de Places en la API de Maps JavaScript. Consulta también la información sobre la opción
placeIdOnly, que se puede usar para reducir el costo de Place Autocomplete.
Cuando se consulta la API de Directions (heredada) o la API de Distance Matrix (heredada) con una cadena de dirección en lugar de un ID de lugar o latlng, usan el mismo backend que la API de Geocoding para convertir esa dirección en un ID de lugar antes de calcular las instrucciones sobre cómo llegar. Place Autocomplete es más rápido que la geocodificación de direcciones. En el caso de las aplicaciones que usan la API de Directions (heredada) o la API de Distance Matrix (heredada) en situaciones muy sensibles a la latencia, como responder a las entradas del usuario, te recomendamos que uses Place Autocomplete para obtener los IDs de lugar correspondientes a esas direcciones y pasarlos a la API de Directions (heredada) o a la API de Distance Matrix (heredada).
Este enfoque reduce significativamente la latencia. Consulta nuestra documentación para ver un
ejemplo de cómo usar Place Autocomplete con instrucciones sobre cómo llegar.
-
¿Cómo informo errores en el geocodificador?
-
Si tienes
informes de errores o
solicitudes de funciones para el servicio de geocodificador de reenvío, comunícate con nosotros a través de nuestro
seguimiento de problemas público.
-
El geocodificador no produce buenos resultados para mi caso de uso. ¿Qué tipo de ayuda se encuentra disponible?
-
Infórmanos mediante nuestro
seguimiento de problemas público y comparte algunas consultas específicas para que podamos investigar si hay errores o problemas sistémicos que causan problemas con la calidad de los resultados, o si hay algún cambio que podamos realizar en la guía de prácticas recomendadas para ayudar a los desarrolladores a obtener mejores resultados.
-
¿Cómo puedo obtener los mejores resultados con el geocodificador mediante el filtrado de componentes?
-
En el geocodificador, el
filtrado de componentes aplica solo las restricciones de postal_code y country. En los siguientes ejemplos, se ilustra cómo usar mejor el filtrado de componentes, según los resultados que necesites. En las URLs de solicitud de muestra, asegúrate de reemplazar "YOUR_API_KEY" por tu clave de API real.
- Para restringir los códigos postales a un país específico, asegúrate de especificar la restricción de país con un código de país ISO 3166-2.
Por ejemplo,
components=country:CH|postal_code:8000 muestra "8000 Zúrich, Suiza".
https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
- Para restringir las consultas a un país específico, asegúrate de especificar la restricción de país con un código de país ISO 3166-2. Es posible que los nombres de los países y otras abreviaturas no generen los mismos resultados que los códigos de país.
Ejemplos:
- La geocodificación de
components=country:FRA|locality:gallus muestra la sublocalidad de Gallus en Frankfurt am Main, Alemania. Esto se debe a que no se admite el código de país de 3 letras para Francia (FRA), por lo que se permiten resultados de cualquier país y el resultado en Frankfurt es más adecuado que cualquier otro en Francia.
https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
- La API de Geocoding no necesariamente mostrará varios resultados para las consultas ambiguas. Place Autocomplete responde mejor a esas consultas.
Ejemplos:
- La geocodificación de
components=country:US|locality:madrid muestra "Madrid, NM 87010, EE.UU.", pero no muestra ninguna de las otras ciudades de EE.UU. que se llaman "Madrid".
https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
- Si usas Place Autocomplete para
input=madrid&components=country:us&types=(regions) y también especificas un viewport con location y radius para
sesgar los resultados de la ubicación, se genera una respuesta con varias ciudades de EE.UU. que se llaman "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
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-31 (UTC)
[null,null,["Última actualización: 2025-08-31 (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 ```"]]
