Obsługa błędów

Po przesłaniu prośby możesz otrzymać odpowiedź zawierającą błąd .

Kafelki 2D i zdjęcia Street View

Poniższa lista zawiera szczegółowe informacje o błędach, które mogą wystąpić podczas korzystania z widoku 2D Kafelki i zdjęcia Street View.

Błąd podczas wyświetlania listy

Poniższa lista zawiera szczegółowe informacje na temat błędów, które mogą wystąpić podczas korzystania z Map Tiles API.

required

W żądaniu brakuje parametru adresu URL. Zwróć uwagę, że komunikat o błędzie informuje, którego parametru brakuje.

notFound, invalid

Twoje x, y lub Wartości (z) są poza zakresem.

• W przypadku zwykłych fragmentów mapy maksymalny poziom powiększenia zależy od kafelek mapy oraz żądane opcje mapy.

• W przypadku zwykłych fragmentów mapy współrzędna x musi znajdować się w zakresie [0, (2^powiększenie)-1].

• W przypadku zwykłych fragmentów mapy współrzędna Y musi mieścić się w zakresie [0, (2^(powiększenie-1))-1].

• W przypadku elementów Street View powiększenie musi wynosić od 0 do 5 włącznie.

• W przypadku kafelków Street View zakresy współrzędnych x i y są takie same jak dla zwykłych fragmentów mapy, aż do powiększenia poziomu 5. Wtedy maksymalna wartości to imageHeight lub imagewidth podzielone przez tileHeight albo tileWidth

forbidden: W żądaniu brakuje prawidłowego klucza interfejsu API.

expired

Twój token session wygasł. Token sesji jest prawidłowy dla dwa tygodnie od momentu utworzenia. Może się to zmienić bez uprzedzenia. Jeśli pojawi się ten błąd, musisz pobrać nową sesję zgodnie z opisem w Użyj tokenów sesji.

badRequest

Żądanie było uszkodzone. Oto częste powody:

• Określono typ mapy terrain bez warstwy roadmap.

• Dodano tablicę styles do typu mapy niezwiązanej z mapą drogową.

• Przesłane przez Ciebie wartości szerokości i długości geograficznej oraz identyfikator panoramy w metadanych Street View użytkownika.

quotaExceeded, rateLimitExceeded

Twoja aplikacja przekroczyła dozwolony limit lub przekroczyła dopuszczalny limit zapytań na sekundę.

Przykładowy błąd

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

Ponawianie prośby

Jeśli żądania quotaExceeded i rateLimitExceeded kończą się niepowodzeniem, ponów żądanie w taki sposób, że uszkodzone żądania lub awarie na dużą skalę nie zapełniają serwerów Goodle'a – bo wielu klientów próbuje w krótkim czasie w kolejności ich stosowania. Oznacza to, że wykładniczy czas do ponowienia gdy spróbujesz ponownie wysłać prośbę. Wykładniczy czas do ponowienia zmusza do rozpowszechniania na czas, by dać serwerowi czas na przywrócenie danych.

Jeśli na przykład żądanie nie powiedzie się, spróbuj ponownie po sekundzie. Ale jeśli również się nie uda, a następnie po 2 sekundach spróbuj przesłać żądanie jeszcze raz. Jeśli także nie powiedzie się, a potem spróbuj ponownie po 4 sekundach. Skutecznie rozprowadzasz kolejne żądania przez podwojenie czasu między kolejnymi żądaniami.

Kafelki 3D

Błędy serwera Google mogą nie być dla Ciebie oczywiste, ponieważ korzystasz z fotorealistycznych kafelków, które odpowiadają za błędów serwera.

Błędy mechanizmu renderowania kafelków

Na przykład mechanizm renderowania CesiumJS zwykle nie działa bez zakłóceń w przypadku błędów serwera. i może prowadzić do awarii, wyświetlania pustych ekranów, kafelki się nie ładują.

Technika stosowana do debugowania błędów serwera będzie zależała od za pomocą mechanizmu renderowania. W przypadku mechanizmów renderowania działających w przeglądarce, takich jak CesiumJS, możesz za pomocą narzędzi wbudowanych w większość przeglądarek. Możesz na przykład: należy użyć funkcji Narzędzia deweloperskie w Chrome

Typowe błędy

Poniższa lista zawiera szczegółowe informacje o najczęstszych błędach, które mogą wystąpić spotkania.

400: nieprawidłowy argument

Nieprawidłowe klucze interfejsu API, parametry zapytania, identyfikatory kafelków lub zestawu kafelków albo sesja, która wygasła token.

403: Odmowa dostępu

Brak klucza interfejsu API, brak połączenia SSL lub klucz interfejsu API nie został dodany do do listy dozwolonych kart 3D. Skontaktuj się z Google zespół pomocy podający identyfikator projektu, który pozwoli Ci zostać dodany; do listy dozwolonych funkcji kafelków 3D w interfejsie Map Tiles API.

429: Zbyt wiele żądań

Twój limit się wyczerpał. Kontakt zespołem pomocy Google, aby zwiększyć swój limit.