Rozwiązywanie problemów

Błędy

W przypadku błędu zwracana jest treść odpowiedzi w standardowym formacie, a kod stanu HTTP jest ustawiany na stan błędu.

Odpowiedź zawiera obiekt z jednym obiektem error z tymi kluczami:

• code: jest to ten sam stan co stan HTTP odpowiedzi.
• message: krótki opis błędu.
• status: kod stanu wskazujący charakter błędu.

Na przykład wysłanie nieprawidłowego parametru placeId spowoduje wyświetlenie tego komunikatu o błędzie:

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

Możliwe błędy:

Wzrastający czas do ponownej próby

Gdy żądania kończą się niepowodzeniem, należy je powtórzyć z użyciem algorytmu Exponential back-off. Jeśli np. żądanie nie powiedzie się za pierwszym razem, spróbuj ponownie po 1 sekundzie. Jeśli nie powiedzie się to ponownie, spróbuj po 2 sekundach, potem po 4 sekundach itd. Dzięki temu nie dochodzi do zalewania serwerów Google nieprawidłowymi żądaniami lub błędami na dużą skalę, ponieważ wielu klientów próbuje bardzo szybko powtórzyć żądania.

Najczęstsze pytania dotyczące rozwiązywania problemów

Problemy z implementacją

Jak często należy pobierać próbki lokalizacji pojazdu?

Zalecamy, aby w przypadku wysokiej jakości wyników „gotowych do wdrożenia” stosować odstępy 1–10 sekund.

Czy istnieje limit liczby punktów, które mogę wysłać w przypadku jednego zapytania?

Tak, zapytanie może mieć maksymalnie 100 punktów.

Jakiego poziomu dokładności powinienem używać do przechowywania par współrzędnych szerokości i długości geograficznej?

Aby zapewnić, że ścieżki przycinane będą podążać za drogami na wszystkich poziomach powiększenia, nawet na maksymalnym poziomie powiększenia, pary współrzędnych przyciętych na szerokość i długość geograficzną powinny być przechowywane z dokładnością do 7 miejsc po przecinku.

Czy do wyświetlania ścieżek z przyciąganiem mogę używać zakodowanych linii łamanych?

Zarysowane wielokąty są określone tylko z dokładnością do 5 miejsc po przecinku, co powoduje błąd wynoszący około 2 metry. Dlatego zakodowane polilinie nie są odpowiednie, jeśli chcesz, aby ścieżki przyciągane do siatki podążały za drogą przy dużym powiększeniu.

Typowe problemy

Niektóre punkty nie są dopasowywane lub występują luki w ścieżkach. Jak mogę to naprawić?

• Jeśli próbkujesz punkty w określonych odstępach czasu, upewnij się, że są one próbkowane w krótszych odstępach (co 1–10 sekund). Jeśli użyjesz dłuższego przedziału (np. 60 sekund), algorytm dopasowywania do drogi może nie być w stanie określić przejechanych dróg z wystarczającą dokładnością.
• Jeśli punkty na mapie tworzysz ręcznie, możesz łatwo tworzyć ścieżki z niewielką liczbą punktów lub z punktami rozrzuconymi, które algorytm łamania nie radzi sobie dobrze. Algorytm przyciągania działa najlepiej w przypadku punktów, które są blisko siebie. Aby przetestować ścieżki, możesz skorzystać z demonstracji funkcji Dopasowanie do dróg lub użyć przeglądarki dróg.

Dlaczego po przybliżeniu ścieżki są postrzępione lub nieco odbiegają od drogi?

• Czy skracasz dokładność par współrzędnych geograficznych przed ich wyświetleniem? Przechowywanie par współrzędnych szerokości i długości geograficznej z dokładnością mniejszą niż 7 cyfr po przecinku powoduje błędy dokładności podczas wyświetlania na mapie ścieżki z przyciśniętymi współrzędnymi.
• Czy używasz zakodowanych wielokątów? Zakodowane linie wielokątne skracają pary współrzędnych szerokości i długości geograficznej do 5 miejsc po przecinku, co powoduje błąd kilku metrów. W wyniku linie są postrzępione lub nieco odbiegają od drogi przy dużym powiększeniu.

Jeśli żadna z tych opcji nie jest prawdziwa, kafelki mapy mogły zostać niedawno zaktualizowane, przez co mogą być niezsynchronizowane z indeksem dróg używanym do snapowania. Jeśli problem dotyczy tylko kilku zapytań, prawdopodobnie jest to przyczyna. Mapy Google są regularnie aktualizowane, dlatego czasami może się to zdarzyć. Może się to zdarzać częściej, jeśli regularnie przeglądasz stare ścieżki na mapie (np. ścieżki, które zostały utworzone kilka tygodni temu). Aby uzyskać optymalną wizualizację, przed wyświetleniem starych ścieżek należy je ponownie przyciąć, aby zminimalizować niezgodności między kafelkami mapy a indeksem dróg używanym do przycinania.

Co może spowodować nieprawidłowe wyświetlanie ograniczenia prędkości na drodze X?

Ograniczenia prędkości pochodzą z kilku źródeł o różnej dokładności i zasięgu. Jeśli zauważysz pewien schemat, np. że ograniczenia prędkości na drogach danego typu lub w danym obszarze są stale nieprawidłowe, poinformuj nas o tym w ten sposób:

1. Otwórz Mapy Google na komputerze albo w aplikacji Mapy Google na Androida.
2. Otwórz menu po lewej stronie.
3. Wybierz Prześlij opinię. Uwaga: może pojawić się prośba o zalogowanie się.
4. Kliknij Edytuj mapę.
5. Wybierz odcinek drogi, który chcesz edytować.
6. Kliknij Dalej.
7. W polu „Inne” zaznacz, że ograniczenie prędkości jest nieprawidłowe dla tej drogi.
8. Wybierz Prześlij.

Tutaj możesz też zgłaszać inne problemy (np. jeśli droga ma nieprawidłową nazwę, jest nieprawidłowo narysowana, zamknięta lub prywatna).

Dlaczego ścieżka przypięta do ścieżki 3D ucina narożniki zamiast podążać za drogą?

Aby rozwiązać ten problem, sprawdź te kwestie:

• Upewnij się, że parametr interpolate ma wartość true.
• Sprawdź, czy oryginalne punkty danych są próbkowane w odpowiednich odstępach czasu (co 1–10 sekund).

Dlaczego na ścieżce przyklejonej do drogi z niezmiennym ograniczeniem prędkości zwracanych jest tak dużo odcinków drogi?

Jeśli parametr interpolate ma wartość true, zapytanie dotyczące dopasowania do drogi zwraca linię łamaną, która podąża za drogą wokół zakrętów, łuków i ronda. Jeśli droga jest kręta, zwracane są różne odcinki drogi, nawet jeśli limit prędkości się nie zmienia, aby utworzyć polilinię, która dokładnie odzwierciedla geometrię drogi.