Omówienie interfejsu Map Management API

Map Management API to interfejs RESTful API, który umożliwia programowe zarządzanie zasobami stylów map w chmurze. Za pomocą tego interfejsu API możesz określać wygląd map, zarządzać tożsamościami map oraz łączyć style niestandardowe i zbiory danych z określonymi wariantami map – a wszystko to bez użycia konsoli Cloud.

Map Management API jest przeznaczony dla deweloperów, którzy chcą zarządzać konfiguracjami map na dużą skalę lub zintegrować stylizację map z własnymi zautomatyzowanymi przepływami pracy i narzędziami wewnętrznymi.

Przydatne zasoby

  • StyleConfig: zawiera reprezentację stylu mapy w formacie JSON. Określa kolory, widoczność i gęstość elementów mapy.
  • MapConfig: reprezentuje unikalną tożsamość mapy (identyfikator mapy). Działa jako kontener ustawień stylizacji i funkcji takich jak zwiększanie widoczności punktów orientacyjnych czy spłaszczanie budynków.
  • MapContextConfig: łączy StyleConfig (i opcjonalnie co najmniej 1 zbiór danych) z określonymi MapVariants w ramach MapConfig.

Kanały wersji interfejsu API

Map Management API używa wersji opartej na kanałach, aby zapewnić przejrzystą ścieżkę od funkcji eksperymentalnych do stabilnych funkcji ogólnie dostępnych.

  • v2alpha (eksperymentalna): zawiera najnowsze funkcje eksperymentalne. Funkcje w tym kanale mogą ulec zmianie bez powiadomienia i nie są zalecane do użytku w środowisku produkcyjnym.
  • v2beta (wersja testowa): zawiera funkcje, które są stabilne i przygotowywane do ogólnej dostępności. Ten kanał jest odpowiedni do wczesnego wdrażania i testowania w środowiskach przedprodukcyjnych.
  • v2 (ogólna dostępność): zawiera w pełni obsługiwane funkcje gotowe do użytku w środowisku produkcyjnym.

Większość funkcji w wersji 2 jest dostępna w punktach końcowych v2alpha i v2beta podczas ich wdrażania. Nowym użytkownikom Google zaleca rozpoczęcie od punktu końcowego v2beta.

Uwierzytelnianie

Do uwierzytelniania w Map Management API możesz używać tylko OAuth 2.0, który nie obsługuje kluczy API. Więcej informacji znajdziesz w artykule Używanie OAuth.

Ograniczenia

  • Role dewelopera: aby korzystać z Map Management API, musisz mieć odpowiednie uprawnienia IAM do zarządzania zasobami Google Maps Platform w projekcie Google Cloud.
  • Zakres zasobów: ten interfejs API koncentruje się na zarządzaniu zasobami stylów map w chmurze. Inne konfiguracje Google Maps Platform mogą nadal wymagać konsoli Cloud.

Koszty

Korzystanie z Map Management API jest bezpłatne. Wywołania interfejsu API są widoczne na stronie Płatności w konsoli Cloud, ale opłaty wynoszą 0 USD. Żądania są jednak ograniczone w następujący sposób:

  • 3 QPS (zapytania na sekundę)
  • 180 QPM (zapytań na minutę) w przypadku projektu, odświeżane co minutę
  • 100 000 QPD (zapytań dziennie) w przypadku projektu, odświeżane każdego dnia

Zobacz Wykorzystanie i płatności.