Dołącz do nas podczas kolejnego wydarzenia Google Maps Platform Developer Community Day, które odbędzie się w grudniu w San Francisco. Zgłoś się, aby wziąć udział.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Obsługa błędów

Deweloperzy z Europejskiego Obszaru Gospodarczego

Po wysłaniu żądania 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 mogą wystąpić podczas korzystania z kafelków 2D i zdjęć Street View.

Błąd podczas wyświetlania listy

Poniżej znajdziesz listę 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 wskazuje, którego parametru brakuje.

notFound, invalid

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

W przypadku zwykłych kafelków mapy maksymalny poziom powiększenia zależy od konkretnego kafelka i 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 kafelkó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 mieścić się w zakresie od 0 do 5.
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 takim przypadku 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 utworzenia. Pamiętaj, że może się to zmienić bez powiadomienia. Jeśli pojawi się ten błąd, musisz uzyskać nowy token sesji, jak opisano w sekcji Używanie tokenów sesji.

badRequest

Twoje żądanie było nieprawidłowo sformatowane. Oto częste powody:

Określono typ mapy terrain bez uwzględnienia warstwy roadmap.
Uwzględniono tablicę styles dla typu mapy innego niż mapa drogowa.
W żądaniu metadanych Street View wysłano wartość szerokości/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 nie powiodą się z powodu błędów quotaExceeded i rateLimitExceeded, należy ponowić żądanie w taki sposób, aby uszkodzone żądania lub awarie na dużą skalę nie przeciążyły serwerów Google, ponieważ wielu klientów próbuje ponowić żądania w krótkich odstępach czasu. Oznacza to, że podczas ponawiania żądań należy używać wzrastającego czasu do ponowienia. Wzrastający czas do ponowienia wymusza rozłożenie żądań w czasie, aby dać serwerowi czas na przywrócenie działania.

Jeśli na przykład żądanie się nie powiedzie, spróbuj ponownie 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 skutecznie rozłożysz w czasie kolejne żądania, po prostu 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 za pomocą mechanizmu renderowania, który odpowiada za obsługę błędów serwera.

Błędy renderowania kafelków

Na przykład mechanizm renderowania CesiumJS zwykle nie wyświetla błędów serwera, co może powodować awarie, puste ekrany lub nieładowanie się określonych kafelków.

Technika debugowania błędów serwera zależy od używanego mechanizmu renderowania. W przypadku mechanizmów renderowania działających w przeglądarce, takich jak CesiumJS, możesz sprawdzać 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 listę najczęstszych błędów, które mogą wystąpić.

400: Nieprawidłowy argument: Nieprawidłowe klucze interfejsu API, parametry zapytania, identyfikatory kafelków lub zbiorów kafelków albo wygasły token sesji.
400: Invalid Value: Upewnij się, że parametr mapType, z którym zostało wysłane żądanie createSessionToken, odpowiada parametrowi mapType używanemu w kolejnym punkcie końcowym kafelka. Na przykład token sesji streetview nie może zostać użyty do żądania kafelka roadmap.

403: Permission denied