Najczęstsze pytania o geokodowanie
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wskazówki dotyczące Geocoding API
Aby uzyskać odpowiedzi na pytania dotyczące wszystkich usług Google Maps Platform, zapoznaj się z najczęstszymi pytaniami na temat Google Maps Platform. Zobacz też sprawdzone metody geokodowania adresów.
Rozwiązywanie problemów
Rozwiązywanie problemów
-
Otrzymuje więcej zapytań, które zwracają ZERO_RESULTS za pomocą geokodera. Co się dzieje?
-
W geokodierze niejednoznaczne, niepełne i źle sformatowane zapytania, takie jak niepoprawnie napisane lub nieistniejące adresy, często prowadzą do wyników ZERO_RESULTS.
Jeśli adres nie zostanie znaleziony, warto użyć parametru ZERO_RESULTS zamiast częściowego wyniku (np. zwracania tylko nazwy przedmieścia zamiast adresu).
Jeśli Twoja aplikacja obsługuje wprowadzanie adresów przez użytkownika, funkcja Autouzupełnianie miejsc w interfejsie Places API może zapewnić lepsze wyniki.
Autouzupełnianie miejsc pozwala użytkownikom wybierać spośród zestawu wyników na podstawie tego, co wpisali. Dzięki temu mogą wybierać spośród wyników o podobnych nazwach, a także dostosowywać zapytanie, jeśli popełnią błąd w adresie.
Jeśli Twoja aplikacja obsługuje niejednoznaczne lub niepełne zapytania albo zapytania, które mogą zawierać błędy, zalecamy użycie funkcji autouzupełniania miejsc w interfejsie Places API zamiast geokodowania wyprzedzającego dostępnego w interfejsie Geocoding API. Więcej informacji znajdziesz w artykule
Sprawdzone metody geokodowania adresów oraz w poście na blogu interfejsów API Map Google
Geokodowanie adresów.
-
Potrzebuję szybkich odpowiedzi, a geokodowanie jest zbyt wolne dla mojej aplikacji. Co mogę zrobić, aby uzyskać szybsze odpowiedzi?
-
Zalecamy, aby aplikacje, które reagują na dane wprowadzane przez użytkownika i są w wypadku opóźnień bardzo czułe, korzystały z funkcji Autouzupełniania miejsc w Places API (dostępnej też w JavaScript, Android i iOS) zamiast geokodowania adresów.
Autouzupełnianie miejsc jest zoptymalizowane pod kątem interakcji, dzięki czemu ma bardzo małe opóźnienie.
Geokodowanie adresów w Geocoding API jest zoptymalizowane pod kątem pełnych, jednoznacznych i prawidłowo sformatowanych adresów, np. adresów dostawy wpisywanych w formularzach online. W związku z tym czas oczekiwania jest dłuższy niż w przypadku autouzupełniania miejsc. Geokodowanie do przodu ma większy zasięg i lepszą jakość wyników, ale z nieco większym opóźnieniem.
-
Jak mogę zmniejszyć opóźnienia w interfejsie Directions API (starsza wersja) i interfejsie Distance Matrix API (starsza wersja)?
-
Zamiast adresów użyj identyfikatorów miejsc, aby określić punkty pośrednie, punkt początkowy i docelowy. Identyfikatory miejsc najlepiej pobrać z funkcji Autouzupełnianie miejsc w interfejsie Places API lub z biblioteki Miejsca w interfejsie Maps JavaScript API. Zapoznaj się też z informacjami o opcji
placeIdOnly, która może pomóc w obniżeniu kosztów autouzupełniania miejsc.
Gdy interfejs Directions API (stara wersja) lub Distance Matrix API (stara wersja) otrzymuje zapytanie z adresem w postaci ciągu znaków zamiast identyfikatora miejsca docelowego lub współrzędnych lat-lng, korzysta z tego samego zaplecza co interfejs Geocoding API, aby przed obliczeniem trasy przekształcić adres w identyfikator miejsca docelowego. Autouzupełnianie miejsc jest szybsze niż geokodowanie adresów. W przypadku aplikacji, które korzystają z interfejsu Directions API (starszego) lub Distance Matrix API (starszego) w sytuacjach bardzo wrażliwych na czas oczekiwania, np. podczas reagowania na dane wejściowe użytkownika, zalecamy użycie autouzupełniania miejsc docelowych, aby uzyskać odpowiadające tym adresom identyfikatory miejsc, a następnie przekazać je do interfejsu Directions API (starszego) lub Distance Matrix API (starszego).
Dzięki temu opóźnienie jest znacznie mniejsze. W naszej dokumentacji znajdziesz
przykład użycia Autouzupełniania miejsc z kierunkami.
-
Jak zgłaszać błędy w geokodierze?
-
Jeśli masz jakiekolwiek
zgłaszanie błędów lub
żądania dotyczące funkcji dotyczące usługi geokodowania wstecznego, daj nam znać, korzystając z publicznego
lokalizatora problemów.
-
W moim przypadku geokodownik nie daje dobrych wyników. Jaka pomoc jest dostępna?
-
Poinformuj nas o tym, korzystając z publicznego
śledzenia problemów, podając kilka konkretnych zapytań, abyśmy mogli sprawdzić, czy występują błędy lub problemy systemowe, które powodują problemy z jakością wyników, lub czy możemy wprowadzić jakieś zmiany w przewodniku po sprawdzonych metodach, aby pomóc deweloperom uzyskać lepsze wyniki.
-
Jak uzyskać najlepsze wyniki za pomocą geokodowania z filtrowaniem komponentów?
-
W geokodierze
filtrowanie komponentów wymusza tylko ograniczenia postal_code i country. Poniższe przykłady pokazują, jak najlepiej stosować filtrowanie komponentów w zależności od potrzebnych wyników. W przykladowych adresach URL żądań zastąp ciąg „YOUR_API_KEY” swoim kluczem interfejsu API.
- Aby ograniczyć kody pocztowe do konkretnego kraju, określ ograniczenie kraju za pomocą kodu kraju w formacie ISO 3166-2.
Na przykład:
components=country:CH|postal_code:8000 zwraca „8000 Zürich, Szwajcaria”.
https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
- Aby ograniczyć zapytania do konkretnego kraju, określ ograniczenie kraju za pomocą kodu kraju w formacie ISO 3166-2. Nazwy krajów i inne skróty mogą nie przynieść takich samych wyników co kody krajów.
Przykłady:
- Geokodowanie adresu
components=country:FRA|locality:gallus zwraca dzielnicę Gallus we Frankfurcie nad Menem w Niemczech. Dzieje się tak, ponieważ 3-literowy kod kraju Francji (FRA) nie jest obsługiwany, więc wyniki we wszystkich krajach są dozwolone, a wynik z Frankfurtu jest lepszy niż cokolwiek we Francji.
https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
- Interfejs Geocoding API niekoniecznie zwróci wielu wyników w przypadku niejednoznacznych zapytań. Takie zapytania lepiej odpowiadają autouzupełnianiu miejsc.
Przykłady:
- Geokodowanie dla
components=country:US|locality:madrid zwraca „Madrid, NM 87010, USA”, ale nie żadne inne miasto w USA o nazwie „Madrid”.
https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
- Korzystając z autouzupełniania miejsc w przypadku
input=madrid&components=country:us&types=(regions) oraz określając widok za pomocą location i radius, aby
ustawić preferencje dotyczące wyników lokalizacji, generuje odpowiedź z kilkoma miastami w USA o nazwie „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
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-31 UTC.
[null,null,["Ostatnia aktualizacja: 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 ```"]]
