Obsługa błędów

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

Kafelki 2D i zdjęcia Street View

Poniżej znajdziesz listę błędów, które możesz napotkać podczas korzystania z płytek 2D i zdjęć Street View.

Lista błędów

Poniżej znajdziesz listę błędów, które mogą wystąpić podczas korzystania z Map Tiles API.

required
Twoje żądanie nie zawiera parametru adresu URL. Pamiętaj, że komunikat o błędzie wskazuje, którego parametru brakuje.
notFound, invalid

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

  • W przypadku zwykłych kafelków mapy maksymalny poziom powiększenia zależy od konkretnego kafelka mapy oraz od wybranych opcji mapy.

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

  • W przypadku zwykłych fragmentów mapy współrzędna y musi należeć do zakresu [0, (2^(zoom-1))-1].

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

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

forbidden: prośba nie zawiera ważnego klucza interfejsu API.

expired
Twój token session wygasł. Token sesji jest ważny przez 2 tygodnie od jego 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 najczęstsze przyczyny:

  • Określono typ mapy terrain bez warstwy roadmap.

  • W przypadku typu mapy innego niż mapa drogowa podano tablicę styles.

  • W prośbie o metadane Street View wysłano wartość lat/lng oraz identyfikator panoramy.

quotaExceeded, rateLimitExceeded

Aplikacja przekroczyła dozwoloną pulę lub dozwoloną liczbę 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 żądań

Gdy żądania kończą się niepowodzeniem z kodem błędu quotaExceeded i rateLimitExceeded, spróbuj ponownie wysłać żądanie w taki sposób, aby nie dochodziło do błędów ani masowych niepowodzeń, ponieważ wielu klientów próbuje wysłać żądania ponownie w krótkich odstępach czasowych. Oznacza to, że podczas ponownego próbowania wysyłania żądań należy stosować odczekiwanie wykładnicze. Wykładniczy czas oczekiwania zmusza Cię do rozłożenia żądań w czasie, aby dać serwerowi czas na odzyskanie się.

Jeśli na przykład żądanie się nie powiedzie, spróbuj ponownie po 1 sekundzie. Jeśli ta próba też się nie powiedzie, spróbuj ponownie po 2 sekundach. Jeśli to żądanie także się nie powiedzie, spróbuj ponownie po 4 sekundach. Dzięki temu kolejne żądania są rozłożone w czasie, ponieważ czas między nimi jest podwajany.

Kafelki 3D

Błędy na serwerze Google mogą być dla Ciebie nieoczywiste, ponieważ uzyskujesz dostęp do fotorealistycznych płytek za pomocą renderera, który odpowiada za obsługę błędów serwera.

Błędy mechanizmu renderowania kafelków

Na przykład renderowanie CesiumJS zwykle kończy się niepowodzeniem, gdy występują błędy serwera. Może to powodować różne problemy, od awarii i pustych ekranów po niewczytywanie się konkretnych płytek.

Technika używana do debugowania błędów serwera zależy od używanego renderera. Mechanizmy renderowania oparte na przeglądarkach, takie jak CesiumJS, umożliwiają badanie ruchu sieciowego za pomocą narzędzi wbudowanych w większość przeglądarek. Możesz na przykład użyć Narzędzi deweloperskich w Chrome.

Typowe błędy

Poniżej znajdziesz 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 płytek lub zestawu płytek albo wygasły token sesji.
403: Odmowa dostępu
Brak klucza interfejsu API, brak połączenia SSL lub klucz interfejsu API nie został dodany do listy dozwolonych dla usługi 3D Tiles. Aby dodać swój projekt do listy dozwolonych w przypadku funkcji mapek 3D interfejsu Map Tiles API, skontaktuj się z zespołem pomocy Google i podaj identyfikator projektu.
429: Zbyt wiele żądań
Twój limit się wyczerpał. Aby zwiększyć limit, skontaktuj się z zespołem pomocy Google.