Skip to content

/AWS1/IF_GEM=>GETTILE()

About GetTile

GetTile returns a tile. Map tiles are used by clients to render a map. they're addressed using a grid arrangement with an X coordinate, Y coordinate, and Z (zoom) level.

For more information, see Tiles in the Amazon Location Service Developer Guide.

Method Signature

METHODS /AWS1/IF_GEM~GETTILE
  IMPORTING
    !IT_ADDITIONALFEATURES TYPE /AWS1/CL_GEMTILEADDLFEATLIST_W=>TT_TILEADDITIONALFEATURELIST OPTIONAL
    !IV_TILESET TYPE /AWS1/GEMTILESET OPTIONAL
    !IV_Z TYPE /AWS1/GEMSENSITIVESTRING OPTIONAL
    !IV_X TYPE /AWS1/GEMSENSITIVESTRING OPTIONAL
    !IV_Y TYPE /AWS1/GEMSENSITIVESTRING OPTIONAL
    !IV_KEY TYPE /AWS1/GEMAPIKEY OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_gemgettileresponse
  RAISING
    /AWS1/CX_GEMACCESSDENIEDEX
    /AWS1/CX_GEMINTERNALSERVEREX
    /AWS1/CX_GEMRESOURCENOTFOUNDEX
    /AWS1/CX_GEMTHROTTLINGEX
    /AWS1/CX_GEMVALIDATIONEX
    /AWS1/CX_GEMCLIENTEXC
    /AWS1/CX_GEMSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_tileset TYPE /AWS1/GEMTILESET /AWS1/GEMTILESET

Specifies the desired tile set.

Valid Values: raster.satellite | vector.basemap

iv_z TYPE /AWS1/GEMSENSITIVESTRING /AWS1/GEMSENSITIVESTRING

The zoom value for the map tile.

iv_x TYPE /AWS1/GEMSENSITIVESTRING /AWS1/GEMSENSITIVESTRING

The X axis value for the map tile. Must be between 0 and 19.

iv_y TYPE /AWS1/GEMSENSITIVESTRING /AWS1/GEMSENSITIVESTRING

The Y axis value for the map tile.

Optional arguments:

it_additionalfeatures TYPE /AWS1/CL_GEMTILEADDLFEATLIST_W=>TT_TILEADDITIONALFEATURELIST TT_TILEADDITIONALFEATURELIST

A list of optional additional parameters such as map styles that can be requested for each result.

iv_key TYPE /AWS1/GEMAPIKEY /AWS1/GEMAPIKEY

Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.

RETURNING

oo_output TYPE REF TO /aws1/cl_gemgettileresponse /AWS1/CL_GEMGETTILERESPONSE

Domain /AWS1/RT_ACCOUNT_ID
Primitive Type NUMC

Examples

Syntax Example

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->gettile(
  it_additionalfeatures = VALUE /aws1/cl_gemtileaddlfeatlist_w=>tt_tileadditionalfeaturelist(
    ( new /aws1/cl_gemtileaddlfeatlist_w( |string| ) )
  )
  iv_key = |string|
  iv_tileset = |string|
  iv_x = |string|
  iv_y = |string|
  iv_z = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_blob = lo_result->get_blob( ).
  lv_string = lo_result->get_contenttype( ).
  lv_string = lo_result->get_cachecontrol( ).
  lv_string = lo_result->get_etag( ).
  lv_string = lo_result->get_pricingbucket( ).
ENDIF.