Omówienie interfejsu Map Management API

Map Management API to interfejs API typu REST, który umożliwia programowe zarządzanie zasobami definiowania stylów map w Google Cloud. Za pomocą tego interfejsu API możesz definiować wygląd map, zarządzać tożsamościami map oraz powiązywać niestandardowe style i zbiory danych z konkretnymi wariantami map – wszystko to bez korzystania z konsoli Cloud.

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

Przydatne zasoby

  • StyleConfig: zawiera reprezentację JSON stylu mapy. Określa on kolory, widoczność i gęstość elementów mapy.
  • MapConfig: reprezentuje unikalną tożsamość mapy (identyfikator mapy). Działa jako kontener ustawień stylów i funkcji, takich jak wzmocnienie ciekawych miejsc czy spłaszczenie budynków.
  • MapContextConfig: wiąże StyleConfig (i opcjonalnie co najmniej 1 zbiór danych) z określonymi MapVariants w MapConfig.

Kanały wersji interfejsu API

Interfejs Map Management API korzysta z wersjonowania opartego na kanałach, aby zapewnić przejrzystą ścieżkę od funkcji eksperymentalnych do stabilnej, ogólnej dostępności.

  • v2alpha (wersja 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 wykorzystania w środowisku produkcyjnym.

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

Uwierzytelnianie

Do uwierzytelniania za pomocą interfejsu Map Management API, który nie obsługuje kluczy interfejsu API, możesz używać tylko protokołu OAuth 2.0. Więcej informacji znajdziesz w artykule o korzystaniu z protokołu OAuth.

Ograniczenia

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

Koszty

Korzystanie z interfejsu 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 zapytania na sekundę
  • 180 zapytań na minutę w projekcie, odświeżane co minutę.
  • 100 000 zapytań dziennie na projekt, odświeżanych codziennie;

Zobacz Użycie i rozliczenia.