Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Obsługa błędów

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Po wysłaniu prośby możesz otrzymać odpowiedź zawierającą szczegóły błędu.

Kafelki 2D i zdjęcia Street View

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

Lista błędów

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

required

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

notFound, invalid

Wartości x, y lub z są spoza zakresu.

W przypadku zwykłych fragmentów mapy maksymalny poziom powiększenia zależy od konkretnego fragmentu mapy i od opcji mapy, o które prosisz.
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 kafelków mapy współrzędna y musi mieścić się w zakresie [0, (2^(zoom-1))-1].
W przypadku kafelków Street View poziom powiększenia musi mieścić się w zakresie 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 aż do poziomu powiększenia 5. W tym momencie maksymalne wartości to imageHeight lub imagewidth podzielone przez tileHeight lub tileWidth.

forbidden:

Możliwe przyczyny:

W żądaniu brakuje prawidłowego klucza interfejsu API.
Wiadomość: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

Kafelki satelitarne 2D nie są dostępne w projektach połączonych z kontem rozliczeniowym z adresem w Europejskim Obszarze Gospodarczym (EOG). Więcej informacji znajdziesz w artykule Zmiany w interfejsie Map Tiles API dla klientów z Europejskiego Obszaru Gospodarczego.

expired

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

badRequest

Żądanie było nieprawidłowo sformatowane. Częste przyczyny:

Określono typ mapy terrain bez uwzględnienia warstwy roadmap.
W przypadku typu mapy innego niż mapa drogowa uwzględniono tablicę styles.
W żądaniu metadanych Street View przesłano wartość szerokości i długości geograficznej oraz identyfikator panoramy.

quotaExceeded, rateLimitExceeded

Aplikacja przekroczyła dozwolony limit 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 kodami quotaExceeded i rateLimitExceeded, należy ponowić żądanie w taki sposób, aby uszkodzone żądania lub awarie na dużą skalę nie zalewały serwerów Google, ponieważ wielu klientów próbuje ponawiać żądania w szybkiej kolejności. Oznacza to, że podczas ponawiania żądań należy stosować wzrastający czas do ponowienia. Wzrastający czas do ponowienia zmusza Cię do rozłożenia żądań w czasie, aby serwer miał czas na odzyskanie sprawności.

Jeśli na przykład żądanie się nie powiedzie, ponów próbę po sekundzie. Jeśli ta próba również się nie powiedzie, ponów żądanie po 2 sekundach. Jeśli to żądanie również się nie powiedzie, spróbuj ponownie po 4 sekundach. W ten sposób możesz skutecznie rozłożyć kolejne prośby, po prostu podwajając czas między nimi.

Kafelki 3D

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

Błędy renderowania kafelków

Na przykład moduł renderujący CesiumJS zwykle nie zgłasza błędów serwera, co może powodować awarie, puste ekrany lub brak wczytywania konkretnych kafelków.

Technika debugowania błędów serwera zależy od konkretnego renderera, którego używasz. W przypadku renderowania w przeglądarce, np. w CesiumJS, możesz sprawdzić ruch w sieci 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 kafelków lub zestawów kafelków albo wygasły token sesji.
400. Nieprawidłowa wartość: Upewnij się, że parametr mapType, z którym wysłano createSessionToken żądanie, jest zgodny z parametrem mapType używanym w kolejnym punkcie końcowym kafelka. Na przykład tokena sesji a streetview nie można użyć do wysłania prośby o roadmap.

403. Odmowa dostępu