Rozwiązywanie problemów

Błędy

W przypadku błędu zwracana jest treść odpowiedzi o błędzie 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 kod stanu 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 zwrócenie tego błędu:

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

Możliwe błędy:

Wzrastający czas do ponowienia

Jeśli żądania się nie powiodą, należy ponawiać je ze wzrastającym czasem do ponowienia. Jeśli na przykład żądanie nie powiedzie się raz, ponów próbę po sekundzie. Jeśli znowu się nie powiedzie, ponów próbę po 2 sekundach, potem po 4 sekundach itd. Dzięki temu uszkodzone żądania lub awarie na dużą skalę nie przeciążą serwerów Google, ponieważ wielu klientów bardzo szybko próbuje ponownie wysłać żądania.

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

Problemy z implementacją

Z jaką częstotliwością mam próbkować lokalizację pojazdu?

Aby uzyskać wysokiej jakości wyniki przyciągania do drogi, zalecamy interwał od 1 do 10 sekund.

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

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

Jaką dokładność należy stosować podczas zapisywania przyciągniętych par współrzędnych geograficznych?

Aby przyciągnięte ścieżki były zgodne z drogami na wszystkich poziomach powiększenia, nawet na maksymalnym poziomie, przechowuj przyciągnięte pary szerokości i długości geograficznej z dokładnością do 7 miejsc po przecinku.

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

Zakodowane polilinie są określane z dokładnością do 5 miejsc po przecinku, co powoduje błąd wynoszący około 2 metry. Zakodowane linie łamane nie nadają się więc, jeśli chcesz, aby przyciągnięte ścieżki przebiegały wzdłuż drogi przy dużych poziomach powiększenia.

Typowe problemy

Niektóre punkty nie są przyciągane lub w przyciągniętych ścieżkach występują luki. Jak mogę to poprawić?

• Jeśli próbkowanie punktów odbywa się 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żywany jest dłuższy interwał (np. 60 sekund), algorytm przyciągania do drogi może nie być w stanie określić przebytych dróg z wystarczającą dokładnością.
• Jeśli klikasz mapę ręcznie, aby utworzyć punkty, możesz łatwo utworzyć ścieżki z małą liczbą punktów lub rzadko rozmieszczonymi punktami, z którymi algorytm przyciągania nie radzi sobie dobrze. Algorytm przyciągania działa najlepiej w przypadku punktów, które są blisko siebie. Wypróbuj demonstrację przyciągania do dróg lub użyj inspektora dróg, aby przetestować ścieżki.

Dlaczego po powiększeniu moje przyciągnięte ścieżki są poszarpane lub lekko odbiegają od drogi?

• Czy przed wyświetleniem przycinasz precyzję przyciągniętych par szerokości i długości geograficznej? Przechowywanie przyciągniętych par szerokości i długości geograficznej z dokładnością mniejszą niż 7 miejsc po przecinku powoduje błędy precyzji, gdy przyciągnięta ścieżka jest wyświetlana na mapie.
• Czy używasz zakodowanych linii łamanych? Zakodowane polilinie obcinają pary współrzędnych geograficznych do 5 miejsc po przecinku, co wprowadza błąd rzędu kilku metrów. W rezultacie linie są poszarpane lub przy dużym powiększeniu nieco odbiegają od drogi.

Jeśli żaden z powyższych przypadków nie ma miejsca, kafelki mapy mogły zostać niedawno zaktualizowane, co spowodowało ich rozsynchronizowanie z indeksem dróg używanym do przyciągania. Jeśli problem dotyczy tylko kilku z Twoich zapytań, prawdopodobnie to jest jego przyczyną. Mapy Google są regularnie aktualizowane, więc takie sytuacje mogą się zdarzać. Mogą występować częściej, jeśli regularnie przeglądasz stare ścieżki na mapie (np. ścieżki, które zostały przyciągnięte kilka tygodni temu). Aby uzyskać optymalną wizualizację, tuż przed wyświetleniem starych ścieżek na mapie należy ponownie przyciągnąć je do dróg, aby zminimalizować niezgodności między kafelkami mapy a indeksem dróg używanym do przyciągania.

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

Ograniczenia prędkości pochodzą z różnych źródeł, które różnią się dokładnością i zakresem. Jeśli zauważysz wzorzec, np. ograniczenia prędkości dla określonego typu drogi lub w określonym obszarze są stale nieprawidłowe, wykonaj te czynności, aby nas o tym poinformować:

1. Otwórz Mapy Google na komputerze lub aplikację Mapy Google na Androida.
2. Otwórz boczne menu.
3. Wybierz Prześlij opinię. Uwaga: może pojawić się prośba o zalogowanie.
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 na tej drodze jest nieprawidłowe.
8. Wybierz Prześlij.

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

Dlaczego przyciągnięta ścieżka skraca drogę 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 wystarczająco krótkich odstępach czasu (co 1–10 sekund).

Dlaczego w przypadku drogi, na której nie ma zmian ograniczenia prędkości, otrzymuję wiele odcinków drogi w dopasowanej ścieżce?

Gdy parametr interpolate ma wartość true, zapytanie o przyciąganie do drogi zwraca linię łamaną, która przebiega wzdłuż drogi na zakrętach, łukach i rondach. Jeśli droga jest zakrzywiona, zwracanych jest wiele odcinków drogi, nawet jeśli ograniczenie prędkości się nie zmienia. Ma to na celu utworzenie linii łamanej, która ściśle odpowiada geometrii drogi.