Obsługa błędów

Po wysłaniu żądania możesz otrzymać odpowiedź ze szczegółowymi informacjami o błędzie.

Kafelki 2D i zdjęcia Street View

Na liście poniżej znajdziesz szczegółowe informacje o błędach, które możesz napotkać podczas korzystania z kart 2D i zdjęć Street View.

Błąd wyświetlania

Na liście poniżej znajdziesz szczegółowe informacje o błędach, które możesz napotkać podczas korzystania z interfejsu Map Tiles API.

required

W żądaniu brakuje parametru adresu URL. Pamiętaj, że komunikat o błędzie wskazuje, którego parametru brakuje.

notFound, invalid

Twoje wartości x, y lub z są poza zakresem.

• W przypadku zwykłych fragmentów mapy maksymalny poziom powiększenia zależy od konkretnego kafelka i od wybranych przez Ciebie opcji.

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

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

• W przypadku kafelkó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 w przypadku zwykłych kafelków mapy, do momentu powiększenia na poziomie 5. W tym momencie maksymalne wartości to imageHeight lub imagewidth podzielone przez tileHeight lub tileWidth.

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

expired

Twój token session wygasł. Token sesji jest ważny przez 2 tygodnie od momentu utworzenia. Pamiętaj, że może się to zmienić bez powiadomienia. Jeśli pojawi się ten błąd, musisz uzyskać nowy token sesji zgodnie z opisem w sekcji Używanie tokenów sesji.

badRequest

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

• Określono typ mapy terrain bez warstwy roadmap.

• Masz podaną tablicę styles dla typu mapy niezwiązanej z mapą.

• W żądaniu metadanych Street View przesłałeś(-aś) wartość szerokości i długości oraz identyfikator panoramy.

quotaExceeded, rateLimitExceeded

Aplikacja przekroczyła dozwolony limit lub przekroczona została dozwolona liczba 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"
  }
}

Ponowne prośby

Jeśli żądania quotaExceeded i rateLimitExceeded kończą się niepowodzeniem, spróbuj wykonać je ponownie, tak aby uszkodzone żądania lub awarie na dużą skalę nie zapełniały serwerów Goodle'a, ponieważ wiele klientów próbuje ponawiać żądania w krótkim czasie. Oznacza to korzystanie z wykładniczego ponowienia przy ponownych żądaniach. Wykładnicze ponawianie zmusza do rozłożenia żądań w odpowiednim czasie, aby dać serwerowi czas na przywrócenie danych.

Jeśli na przykład żądanie nie powiedzie się, spróbuj ponownie po sekundzie. Jeśli jednak ta próba również się nie powiedzie, ponów żądanie po 2 sekundach. Jeśli żądanie także się nie powiedzie, spróbuj jeszcze raz po 4 sekundach. Możesz więc skutecznie rozdzielić kolejne żądania, podwajając czas między nimi.

Kafelki 3D

Błędy serwera Google mogą nie być dla Ciebie oczywiste, ponieważ uzyskujesz dostęp do fotorealistycznych kafelków przez mechanizm renderowania, który odpowiada za obsługę błędów serwera.

Błędy mechanizmu renderowania kafelków

Na przykład mechanizm renderowania CesiumJS zwykle ulega awarii po wystąpieniu błędów serwera, co może prowadzić do awarii, pustych ekranów czy niewyświetlania się konkretnych kafelków.

Metoda używana do debugowania błędów serwera zależy od używanego mechanizmu renderowania. W przypadku mechanizmów renderowania w przeglądarce, takich jak CesiumJS, możesz badać ruch sieciowy za pomocą narzędzi wbudowanych w większości przeglądarek. Możesz na przykład użyć Narzędzi deweloperskich w Chrome.

Typowe błędy

Poniższa lista zawiera szczegółowe informacje o najczęstszych błędach, które możesz napotkać.

400: nieprawidłowy argument

Nieprawidłowe klucze interfejsu API, parametry zapytania, identyfikatory kafelków lub zestawu kafelków albo wygasły token sesji.

403: Brak uprawnień

Brak klucza interfejsu API, brak połączenia SSL lub Twój klucz interfejsu API nie został dodany do listy dozwolonych kafelków 3D. Jeśli chcesz, aby Twój identyfikator projektu został dodany do listy dozwolonych w zakresie funkcji kafelków 3D w interfejsie Map Tiles API, skontaktuj się z zespołem pomocy Google.

429: Zbyt wiele żądań

Twój limit został wyczerpany. Aby zwiększyć limit, skontaktuj się z zespołem pomocy Google.